Skip to main content
POST
Report Status
Always report status after checkout execution: this updates transaction records and relays the outcome to the card network. Report DECLINED if a payment token was used but checkout failed.

Notes

  • A mandate is the spending permission created when the cardholder approved the payment. Mandates are currently one-time: an APPROVED status automatically consumes the mandate (it can’t be reused). Recurring mandate frequencies are planned; once available, APPROVED will keep a recurring mandate active for future invocations.
  • product_statuses is optional and informational; the overall mandate status follows txn_status.

Error responses

Authorizations

Authorization
string
header
required

Your secret key: sk_test_* (sandbox) or sk_live_* (production).

Path Parameters

sessionId
string
required

The session ID returned from Create Session

Body

application/json
txn_ref_id
string
required

The transaction line item reference ID (from Get Payment Result)

txn_status
enum<string>
required

The payment outcome

Available options:
APPROVED,
DECLINED
txn_type
string
default:PURCHASE

Transaction type

authorization_code
string

Authorization code from the merchant's payment processor

Maximum string length: 128
response_code
string

Processor response code, e.g. "00" for approved

Maximum string length: 2
amount_paid
string

Override the total amount paid, if different from the original

product_statuses
object[]

Optional per-product status overrides

Response

Status confirmed

status
string

Always "confirmed"

txn_ref_id
string
txn_status
enum<string>
Available options:
APPROVED,
DECLINED
visa_confirmation
enum<string>
Available options:
SUCCESS,
FAILURE