Алмасудың жалпы ережелері

Операция идентификаторлары

Агент жағындағы әр операцияның бірегей agentTransactionId идентификаторы болуы тиіс. Бұл идентификатор өзара есеп айырысуларды салыстыру және даулы жағдайларды реттеу үшін пайдаланылады.

Процессинг жағында әр операцияға өзінің transactionId идентификаторы сәйкес келеді. Ол жауаптарда қайтарылады және процессинг жүйесінде төлемді іздеу үшін қолданылады.

Сомалар

amountTo және amountFrom сомалары жүздікке дейінгі дәлдікпен ондық сандар ретінде беріледі. Бөлгіш ретінде нүкте қолданылады:

180.00

Операция күні

pay сұрауында agentTransactionDate өрісі YYYY-MM-DDThh:mm:ss форматында беріледі және Агент жағында клиенттен сұрауды алу күнін көрсетеді. Дәл осы күн өзара есеп айырысу және бухгалтерлік салыстыру кезінде пайдаланылады.

Төлеуші идентификаторы

Төлеуші идентификаторы account өрісінде беріледі. Өріс Сервиске байланысты телефон нөмірін, жеке шотты, логинді, email-ді және басқа мәндерді қамтуы мүмкін.

account мәнінің дұрыстығы Агент жағында Сервистер анықтамалығынан алынған тұрақты өрнек бойынша тексерілуі тиіс.

Қосымша деректер

Сервис қосымша деректер талап етсе, олар extras объектісінде беріледі. Бұл тапсырыс нөмірі, email, терминал нөмірі, төлем түрі және басқа мәндер болуы мүмкін.

{
  "extras": {
    "orderId": "ORD-123456",
    "email": "client@example.com",
    "terminalId": "T001",
    "paymentType": "card"
  }
}

Төлем кезеңдері

Төлем екі кезеңде жүзеге асырылады:

Кезең	Әдіс	Сипаттама
1	check	Алдын ала тексеру
2	pay	Төлемді жүргізу

Нәтиже кодтары

Өңдеу нәтижесі result параметрінде қайтарылады.

Код	Мән
0	Сәтті
Басқа түпкілікті код	Операция қатемен аяқталды
Уақытша код	Қайталап сұрау қажет

Ескерту

Код уақытша болса, Агент түпкілікті мәртебе алынғанша сұрауды арасын ұлғайта отырып қайталауы тиіс.