Saltar al contenido principal
Migo Docs

QuickPay QR — El Salvador, Honduras y Costa Rica

QuickPay QR es el único rail cableado en el endpoint /payments de pagos alternativos para estos tres países. La integración es idéntica en los tres: solo cambian el prefijo telefónico y la moneda del comercio. (En Guatemala el mismo rail existe junto a otros; ve Guatemala.)

PaísPrefijo E.164Moneda
El Salvador+503USD
Honduras+504HNL
Costa Rica+506CRC

Setup​

Configura estas variables en tu shell antes de ejecutar cualquier curl. El host (sb-mw.migopayments.com) y el path (/api/v1/integrations/...) son el sandbox público alcanzable por integradores externos. Las rutas de Pagos Alternativos aceptan el token de comercio de 64 caracteres como token Bearer.

export MIGO_BASE="https://sb-mw.migopayments.com"
export MIGO_CLIENT="<your-client-slug>"
export MIGO_TOKEN="<your-64-char-merchant-token>" # 64 hex chars
export MIGO_USER_ID="+50600000000" # usa el prefijo de tu país

export UID=$(
curl -s -X POST "$MIGO_BASE/api/v1/integrations/transactions" \
-H "Authorization: Bearer $MIGO_TOKEN" \
-H "Content-Type: application/json" \
-d "{
\"amount\": 250000,
\"channel\": \"web\",
\"client\": \"$MIGO_CLIENT\",
\"userId\": \"$MIGO_USER_ID\",
\"customKeys\": { \"orderId\": \"recipe-test\" }
}" | jq -r '.data.uid'
)

Inspecciona los paymentMethods de la respuesta para confirmar qué rails tiene habilitados tu cliente; se resuelven en runtime desde clientConfig.processors.

Procesar el pago (quickPayQR)​

Agregador QR interbancario. No requiere un payment-intents previo y responde un payload de tipo json.

curl -X POST "$MIGO_BASE/api/v1/integrations/transactions/$UID/payments" \
-H "Authorization: Bearer $MIGO_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "processor": "quickPayQR", "data": {} }'

El type y data de la respuesta vienen directo del paymentRequest del procesador:

{
"success": true,
"message": "Success",
"data": {
"transaction_id": "…",
"type": "<paymentRequest.type>",
"data": "<paymentRequest.data>",
"cancelAt": null
}
}

Renderiza el payload del QR desde data.data. El estado del pago llega después por el callback del comercio configurado en clientConfig.callback — ve Merchant Generic Callback.

quickPayQR soporta revert vía POST $MIGO_BASE/revert con body {"transactionUid":"$UID","processor":"quickPayQR"}. Esa superficie usa el esquema JWT-Bearer, separado del token de comercio que usas aquí.

Errores​

El middleware de pagos alternativos devuelve códigos de 4 dígitos en error.code, no el catálogo 7xxx del ALI Gateway:

HTTPerror.codeCuándo
4005000Params faltantes o inválidos (amount, channel, client, userId, customKeys, processor)
400—processor no permitido para este cliente
4005004Config del cliente no encontrada
4002002Falló la creación de la transacción
4002003Monto fuera del rango permitido

Consulta el Catálogo de errores para la descripción completa de cada código.

Relacionado​