Saltar al contenido principal
Migo Docs

México — recetas de integración

México no tiene rails de /payments de pagos alternativos cableados hoy. Los pagos con tarjeta — incluido Apple Pay — se procesan a través del webview hosteado vía Payment Links, enrutados a t1pagos o visa-cybersource según el BIN. Apple Pay no es una llave de procesador en el dispatch map de pagos alternativos (applePayT1 / applePayCyber existen solo como alias de revert/refund/capture del procesador Visa Cybersource subyacente, no como rails de /payments).

Usa Payment Links para México. Crea el cobro con POST /transactions (o /transactions-hook) y deja que el cliente lo liquide dentro del webview hosteado por Migo. El webview presenta Apple Pay donde el dispositivo y el comercio lo soportan; el cobro subyacente se enruta a través de t1pagos / visa-cybersource.

Setup (hazlo una sola vez)​

Los Payment Links usan el token de comercio de larga duración de 64 caracteres enviado como Authorization: <token> (sin prefijo de esquema) — ve Autenticación → Formato del header por 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" }
  }'

Envía la URL de checkout retornada al cliente. En el webview puede pagar con tarjeta o, donde se soporte, con Apple Pay — el cobro lo procesa el procesador de tarjeta configurado (t1pagos / visa-cybersource). Ve Crear un Payment Link para el contrato completo de request/response y Procesadores de Payment Link para el catálogo de procesadores del webview.

Refund / reversión​

Las reversiones y reembolsos de tarjeta para los procesadores subyacentes están disponibles en la superficie middleware-pay vía POST $MIGO_BASE/revert y POST $MIGO_BASE/refund (esquema JWT-Bearer). Para cobros con Apple Pay, los alias de revert/refund (applePayT1, applePayCyber) resuelven al void/refund de Visa Cybersource.

Checklist final​

  • POST /transactions retornó una URL de webview para country: "MX", currency: "MXN".
  • El cliente completó un cobro con tarjeta (o Apple Pay) en el webview de sandbox.
  • Refund/reversión ejercitado contra el procesador de tarjeta subyacente.

¿Necesitas el catálogo completo de procesadores del webview? El webview enruta a t1pagos, visa-cybersource, o openpay según el BIN — ve Procesadores de Payment Link.