Списание по предварительной авторизации (Capture Pre-Authorization)
Спишите средства по ранее авторизованному платежу. Вы можете списать полную или частичную сумму.
POST
/api/pre-authorization/{paymentId}/captureПараметры пути (Path Parameters)
| Параметр | Тип | Описание |
|---|---|---|
| paymentId | string | UUID платежа с предварительной авторизацией. |
Параметры запроса (Request Parameters)
- Параметры
- Пример запроса
| Параметр | Обязателен | Тип | Описание |
|---|---|---|---|
| amount | Да | number | Сумма для списания (может быть меньше или равна сумме предварительной авторизации) (например, 90.00). |
| currency | Да | string | Код валюты (например, TRY). |
{
"amount": 90.00,
"currency": "TRY"
}
Ответ (Response)
Возвращает объект ApiPaymentResponse с подробностями списания.
- Поля ответа
- Пример ответа
| Поле | Тип | Описание |
|---|---|---|
| paymentId | string | Уникальный идентификатор платежа (UUID). |
| orderId | string | Номер заказа для отслеживания. |
| amount | number | Сумма транзакции. |
| installmentCount | number | Количество рассрочек. |
| currency | string | Код валюты. |
| merchantCommission | number | Комиссия, взимаемая с мерчанта. |
| status | string | Статус платежа (например, SUCCESS, FAILED, ENROLLED). |
| paymentDate | string | Дата и время платежа (формат ISO, например, 2023-05-01T14:30:00Z). |
| cardHolderName | string | Имя держателя карты. |
| pan | string | Маскированный номер карты (например, 411111******1111). |
| domInt | string | Внутренняя или международная транзакция (DOM/INT). |
| cardScheme | string | Платежная система (например, VISA, MASTERCARD). |
| cardType | string | Тип карты (например, CREDIT, DEBIT). |
| loyaltyCode | string | Код программы лояльности (если применимо). |
| externalTransactionId | string | Идентификатор транзакции от платежного провайдера. |
| authCode | string | Код авторизации от платежного провайдера. |
| resultCode | string | Код результата от платежного провайдера. |
| resultMessage | string | Сообщение о результате от платежного провайдера. |
| customerId | string | Уникальный идентификатор клиента (если был предоставлен). |
Успех
{
"paymentId": "123e4567-e89b-12d3-a456-426614174000",
"orderId": "ORD-12345",
"amount": 100.50,
"installmentCount": 3,
"currency": "TRY",
"merchantCommission": 2.50,
"status": "SUCCESS",
"paymentDate": "2023-05-01T14:30:00Z",
"cardHolderName": "John Doe",
"pan": "411111******1111",
"domInt": "DOM",
"cardScheme": "VISA",
"cardType": "CREDIT",
"loyaltyCode": "GOLD123",
"externalTransactionId": "EXT123456789",
"authCode": "AUTH987654",
"resultCode": "SUCCESS",
"resultMessage": "Successful",
"customerId": "CUST-12345"
}