Алуучуну текшерүү

POST /v2/recipient · API статусу: stable · Кол коюу: милдеттүү

Төлөм түзүүдөн мурун алуучунун бар экенин текшерет. Колдонуучуга алуучунун атын көрсөтүп, акчаны «эч жакка» жөнөтпөш үчүн POST /v2/payment алдында чакырууну сунуштайбыз.

Сурам телеси

Параметр	Түрү	Милдеттүү	Сүрөттөмө
`fields`	Object	Милдеттүү	Алуучунун реквизиттери `ачкыч: мааниси` түгөйлөрү менен, мисалы `"phone": "+996502502502"`. Талаалардын топтому кызматка жараша болот — `POST /v2/services` ичиндеги `requiredFields` караңыз.
`service`	String	Милдеттүү	Finik домениндеги кызматтын ID.

Сурамдын мисалы

POST /v2/recipient

POST /v2/recipient HTTP/1.1
Host: api.paymentsgateway.averspay.kg
Content-Type: application/json
signature: <signature>
x-api-key: <apiKey>
x-api-timestamp: 1719900000000 // Use Date.now() for the current timestamp.

{
  "fields": {
    "amount": 100,
    "phone": "+996502502502"
  },
  "service": "averspay"
}

Жооп

Параметр	Түрү	Милдеттүү	Сүрөттөмө
`statusCode`	Number	Милдеттүү	Жооптун статусу.
`name`	String	Милдеттүү эмес	Алуучунун аты-жөнү, эгер кызмат көрсөтүүчү мындай маалыматты кайтарса. Finik кызматы үчүн — инициалдар, мисалы А. У.
`phone`	String	Милдеттүү эмес	Алуучунун реквизити. Finik кызматы үчүн бар.

Жооптордун мисалдары

200 OK — алуучу табылды

{ "statusCode": 200, "name": "А. У.", "phone": "+996502502502" }

404 Not Found — алуучу жок

{ "statusCode": 404, "errorMessage": "User does not exist." }

400 Bad Request — алуучу бөгөттөлгөн

{ "statusCode": 400, "errorMessage": "User is disabled." }