Tarlanpayments
Рус
Рус
  • Платежный шлюз
    • Общая информация
      • Процесс одностадийного платежа
      • Процесс двухстадийного платежа
      • Виды операций
      • 3D-Secure
      • PCI DSS
    • Типы транзакций
    • Структура ответов системы
    • Коды ошибок
    • Статусы транзакций
    • Формирование подписи
    • Дополнительные параметры
    • Взаимодействие с формой оплаты
      • Инициация приёма денежных средств
      • Инициация вывода денежных средств
      • Привязка карты
      • Инициация приёма денежных средств посредством Apple Pay
      • Инициация приёма денежных средств посредство Google Pay
      • Iframe
    • Платежи без формы оплаты
      • Платеж по сохраненной карте (one click)
      • Вывод денежных средств (pay-out)
      • Шифрование платежной карты
    • Вспомогательные методы
      • Удаление привязанной карты
      • Проверка статуса транзакции
      • Получение списка карт
      • Возврат платежа
      • Расчет верхней комиссии
      • Подтверждение списания средств
      • Отмена списания средств
    • Webhook платежной системы
      • Статус оплаты
      • Готовность проведения оплаты
    • Smart Pay
      • Google pay
    • CMS
      • WordPress
      • Bitrix
      • Tilda
    • Сводка изменений
  • AGWS
    • Коды состояния аккаунта
    • Статусы транзакции
    • Коды ошибок
    • Причина отклонения операции
    • Время жизни транзакции
    • Формирование подписи
    • Проверка состояния аккаунта
    • Проведение платежа
    • Проверка статуса пополнения
    • Проверка остатка баланса на счету
    • Подтверждение списания средств
    • Создание ссылки на оплату
    • Информация по услугам
    • Получение информации о юзере
    • Callback платежной системы
  • Получение фискального чека
  • Расчет верхней комиссии
Powered by GitBook
On this page
  1. AGWS

Подтверждение списания средств

Last updated 3 days ago

ВНИМАНИЕ: Новый формат ответа для ошибок

В ближайшее время в нашей системе ошибки будут разделены на ожидаемые и неожидаемые. Это приведет к изменению формата JSON-ответа в зависимости от типа ошибки. Пожалуйста, ознакомьтесь с изменениями на странице . Изменения будут применены ко всем API в системе AGWS, за исключением методов «».

Нажмите , чтобы просмотреть старые и новые ответы об ошибках JSON. Обратите внимание на это обновление и убедитесь, что ваша система готова к изменениям, если это необходимо.

Для некоторых услуг необходимо подтверждать списание используя дополнительные атрибуты например отп-код.

POST https://agwsapi.tarlanpayments.kz/showcase-gateway/api/v1/action/confirm/invoice

Headers

Name
Value

Content-Type

application/json

X-Signature

Body

Name
Type
Description

agent*

String

Код витрины в системе Tarlanpayments

confirm_code

String

Код подтверждения платежа

external_id*

String

Идентификатор платежа на стороне витрины

Response

Name
Type
Description

status

bool

Статус обработки запроса

status_code

uint

Код ошибки

message

string

Оисание ошибки

result

Object

Объект хранящий информацию о платеже

-is_success

String

Флаг успешности платежа

-transaction_status_id

String

-fail_reason

Object

-external_id

String

Идентификатор платежа на стороне витрины

-otp_status

bool

Флаг успешности проверки otp

{
    "status": true,
    "status_code": 0,
    "message": "Success",
    "result": {
        "is_success": true,
        "transaction_status_id": "4",
        "external_id": "200001",
        "message": "",
        "otp_status": false,
        "fail_reason": {
            "code": 402,
            "message": "Incorrect confirmation code"
        }
    }
}

Примеры ответов об ошибках до внесения изменений

{
    "status": false,
    "status_code": 1041,
    "message": "Order not found",
    "result": {}
}
{
    "status": false,
    "status_code": 1014,
    "message": "Invalid signature",
    "result": {}
}

Примеры ответов об ошибках после внесения изменений

{
    "status": true,
    "status_code": 0,
    "message": "Success",
    "result": {
        "error_code": 1041,
        "message": "Order not found",
        "data": null
    }
}
{
    "status": false,
    "status_code": 1014,
    "message": "Invalid signature",
    "result": {}
}
curl --location 'https://agwsapi.tarlanpayments.kz/showcase-gateway/api/v1/action/confirm/invoice' \ 
--header 'Content-Type: application/json' \ 
--data '{ 
    "agent": "test_agent",
    "confirm_code": "104000", 
    "external_id": "externa312" 
}'

Поле содержащее

Коды Ошибок
Проведение платежа
здесь
Авторизационный хэш
Статус транзакции
причину неуспеха