v12

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-011518127.5 KB
Direct Integration

Process Transaction

Process both payments and withdrawals through a single API call. This unified endpoint handles all transaction types based on the operation_type field.

post/process/

Request body

operation_type'payment' | 'withdrawal' required

Type of transaction to process

amountnumber required

Transaction amount

currency'MXN' | 'USD'

Currency code

client_referencestring

Your reference identifier

metadataobject

Additional data for your records

return_urlstring uri

URL for redirection after 3DS processing

transfer_method'SPEI' | 'DEBIT_CARD'

Transfer method for withdrawals

referencestring

Your withdrawal reference

descriptionstring

Withdrawal description

Response

Transaction processed successfully

idstring uuid

Unique transaction identifier

operation_type'payment' | 'withdrawal'

Type of transaction

status'pending' | 'on_hold' | 'processing' | 'sent_to_provider' | 'success' | 'paid_full' | 'in_transit' | 'authorized' | 'canceled' | 'declined' | 'rejected' | 'failed' | 'Unknown' | 'expired'

Current transaction status

amountnumber

Transaction amount

currencystring

Currency code

client_referencestring

Your reference identifier

payment_idinteger

Payment ID (for payments)

transaction_idstring

Provider transaction ID

providerstring

Payment provider used

created_atstring date-time

ISO 8601 timestamp of creation

status_codeinteger

HTTP status code