Маалымдама

Endpoint даректери жана каталар

Endpoint даректери

Чөйрө	URL
`Бета`	https://beta.api.acquiring.averspay.kg/v1/payment
`Продакшен`	https://api.acquiring.averspay.kg/v1/payment

Жалпы каталар

Статус	Мааниси
`400`	Туура эмес сурам. Мисалы, убакыт белгиси жараксыз/жок же Amount ≤ 0.
`401`	Кол тамга жараксыз.
`403`	Тыюу салынган.

400 Bad Request

{ "statusCode": 400, "ErrorMessage": "A valid UNIX timestamp must be provided in the header" }
{ "statusCode": 400, "ErrorMessage": "An invalid amount is provided. Amount must be greater than 0." }

401 Unauthorized

{ "statusCode": 401, "ErrorMessage": "An invalid signature is provided" }

403 Forbidden

{ "statusCode": 403, "ErrorMessage": "Forbidden" }

Ачык ачкычтар

Вебхук кол тамгаларын текшерүү үчүн чөйрөңүзгө ылайыктуу ачык ачкычты колдонуңуз.

Продакшен — public-key.pem

Бета — public-key.pem

FAQ

Finik Web SDK менен интеграцияны кантип баштайм?

Бул документацияны изилдеңиз: RSA ачкычтарын генерациялаңыз («Ачкычтарды түзүү» бөлүмүн кара), андан кийин Finik жеке кабинетинде API-ачкыч түзүңүз. Жеке ишкерлер үчүн — колдонмо жана жеке кабинет аркылуу. Уюмдар үчүн — Finik өкүлдөрүнө кайрылыңыз, алар ар бир кадамда жардам берет.

Web SDK үчүн API-ачкычтарды кантип алам?

Алгач openssl командалары аркылуу RSA ачкычтарын генерациялаңыз («Ачкычтарды түзүү» бөлүмүн кара). Андан кийин Finik жеке кабинетине кириңиз, «Ачкычтар» бөлүмүн ачып, «Ачкычты генерациялоо» баскычын басыңыз — ачык ачкычыңызды жана WEB түрүн көрсөтүңүз. Даяр: интеграция үчүн x-api-key аласыз.

Web SDK үчүн бета жана продакшен чөйрөлөрүнүн айырмасы эмнеде?

Бета чөйрөсү интеграцияны оңдоо үчүн колдонулат — реалдуу акча эсептен чыгарылбастан төлөмдөрдү түзө аласыз. Продакшен чөйрөсү реалдуу каражаттар менен иштейт. Ар бир чөйрөгө өзүнчө API-ачкычтар берилет: бета — https://beta.api.acquiring.averspay.kg/v1/payment, прод — https://api.acquiring.averspay.kg/v1/payment.

Бул ката адатта туура эмес API-ачкычтан улам келип чыгат.

Төмөнкүлөрдү текшериңиз:

API-ачкычы туура чөйрөдө (beta же production) колдонулуп жатабы. Жалпы себеп — beta API-ачкычын продакшен чөйрөсүндө же тескерисинче колдонуу. API-ачкычы туура көчүрүлдүбү. Көчүрүүдө ачкычтын башында же аягында бир нече символ кездейсоктон өткөрүлүп жиберилиши мүмкүн. Актуалдуу жана колдонуудагы API-ачкыч колдонулуп жатканын текшериңиз.

Көпчүлүк учурларда ката туура эмес API-ачкычты колдонуу же аны туура эмес көчүрүүгө байланыштуу.

Callback URL деген эмне жана Web SDK үчүн аны кантип орнотом?

Callback URL — биз төлөм статусу боюнча (ийгилик/ката) POST-билдирүүлөрдү жөнөтө турган сервериңиздин дареги. Бул милдеттүү эмес, бирок автоматташтыруу үчүн сунушталат. Аны ачык ачкычты жөнөтүүдө же кийинчерээк жеке кабинет аркылуу көрсөтсөңүз болот. Билдирүүнүн форматы документацияда сүрөттөлгөн.

Эмне үчүн Callback URL дарегиме суроо-талаптар келбейт?

Серверинизге сырттан жетүүгө болорун, HTTPS колдонорун жана POST-суроо-талаптарды кабыл ала тургандыгын текшериңиз. Ошондой эле Callback URL параметрлерде туура көрсөтүлгөнүн текшериңиз (доменде каталар жок). Баары туура болсо — сервериңиздин логдорун текшериңиз жана билдирүүлөрдүн жеткирилишин текшерүү үчүн бизге кайрылыңыз.

Бир эле ачык ачкычты бир нече мерчанттар үчүн колдонсо болобу?

Жок, ар бир мерчант өзүнүн уникалдуу ачык ачкычына ээ болушу керек. Ар бир юридикалык жак же ЖИ үчүн өзүнчө ачкыч жубу генерацияланат. Бул коопсуздук талабы.

Бета чөйрөсүндө тестирлөө үчүн баланс толуктоо керекпи?

Жок, бета-чөйрөдө толуктоо талап кылынбайт, анткени төлөмдөр реалдуу каражаттарды эсептен чыгарбайт. Бирок тест үчүн продакшен чөйрөсүн колдонсоңуз, эсебиңизди толуктоо керек, анткени реалдуу акча эсептен чыгарылат (транзакция боюнча комиссия).

Web SDK аркылуу төлөм түзүүдө кандай маалыматтарды берүү керек?

Милдеттүү талаалар: CardType (дайыма FINIK_QR), PaymentId (уникалдуу UUID), RedirectUrl жана accountId, name_en, webhookUrl талааларын камтыган Data объектиси. Amount талаасы опционал — көрсөтүлбөсө, кардар суммасын өзү киргизет. Чоо-жайы — «Суроо-талаптын денеси» бөлүмүндө.

Интеграция туура иштеп жатканын кантип билем?

Бета-чөйрөдө минималдуу суммага (мисалы, 0.01 сом) тесттик төлөм жасаңыз. Эгер ийгиликтүү жооп алсаңыз жана транзакцияны жеке кабинетте көрсөңүз (мүмкүнчүлүк болсо), ошондой эле Callback URL дарегиңизге билдирүү келсе (эгер орнотсоңуз) — интеграция иштейт.