Skip to main content
Migo Docs

México — integration recipes

México has no alternative-payments /payments rails wired today. Card payments — including Apple Pay — are processed through the hosted webview via Payment Links, routed to t1pagos or visa-cybersource depending on the BIN. Apple Pay is not a processor key on the alternative-payments dispatch map (applePayT1 / applePayCyber exist only as revert/refund/capture aliases of the underlying Visa Cybersource processor, not as /payments rails).

Use Payment Links for México. Create the charge with POST /transactions (or /transactions-hook) and let the customer settle it inside the Migo-hosted webview. The webview presents Apple Pay where the device and merchant support it; the underlying charge is routed through t1pagos / visa-cybersource.

Setup (do this once)​

Payment Links use the long-lived 64-char merchant token sent as Authorization: <token> (no scheme prefix) — see Authentication → Header format by endpoint.

export MIGO_BASE="https://sb-mw.migopayments.com"
export MIGO_TOKEN="<your-64-char-merchant-token>" # 64 hex chars
export MIGO_USER_ID="+52155000000"
curl -X POST "$MIGO_BASE/transactions" \
  -H "Authorization: $MIGO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50000,
    "currency": "MXN",
    "country": "MX",
    "channel": "web",
    "userId": "'"$MIGO_USER_ID"'",
    "customKeys": { "orderId": "your-internal-order-id" }
  }'

Send the returned checkout URL to the customer. In the webview they can pay by card or, where supported, Apple Pay — the charge is processed by the configured card processor (t1pagos / visa-cybersource). See Create a Payment Link for the full request/response contract and Payment Link processors for the webview processor catalog.

Refund / reversal​

Card reversals and refunds for the underlying processors are available on the middleware-pay surface via POST $MIGO_BASE/revert and POST $MIGO_BASE/refund (JWT-Bearer scheme). For Apple Pay charges, the revert/refund aliases (applePayT1, applePayCyber) resolve to the Visa Cybersource void/refund.

Final checklist​

  • POST /transactions returned a webview URL for country: "MX", currency: "MXN".
  • Customer completed a card (or Apple Pay) charge in the sandbox webview.
  • Refund/reversal exercised against the underlying card processor.

Need the full webview processor catalog? The webview routes to t1pagos, visa-cybersource, or openpay depending on the BIN — see Payment Link processors.