Get payment
Returns payment details and current transaction state for a checkout session.
Request
/pay/api/payment/{checkoutSessionId}
Authorization: Bearer {token} — role VpayTerminal
Path parameters
| Parameter | Type | Description |
|---|
checkoutSessionId | string | Session ID from start-payment or generate-payment-link |
Response 200
| Field | Type | Description |
|---|
totalTransactionAmount | string | Transaction amount |
currencyCode | string | Currency code |
transactionReferenceNumber | string | Merchant reference |
authorizationCode | string | Authorization code when approved |
state | integer | Transaction state |
{
"totalTransactionAmount": "1500.00",
"currencyCode": "CRC",
"transactionReferenceNumber": "ORDER-2026-001",
"authorizationCode": "ABC123",
"state": 1
}
Errors
| Status | Type | Description |
|---|
401 | — | Unauthorized |
404 | VPAY_007 | Payment not found |
422 | VPAY_002 | Session does not exist |
500 | — | Internal error |
Example
curl -X GET "{sandboxBaseUrl}/pay/api/payment/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
-H "Authorization: Bearer YOUR_TOKEN"
