Sign in
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

Changes

Changed in 2 of the 12 revisions of this API.12

  • aface34fb9b211See the full diff
    • ▲

      removed the enum value MERCADOPAGO of the request property /

      request-property-enum-value-removed

    • ○

      added the new mercadopago enum value to the request property /

      request-property-enum-value-added

  • 542eb586f7e01See the full diff
    • ○

      endpoint added

      endpoint-added