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ís | Prefijo E.164 | Moneda |
|---|---|---|
| El Salvador | +503 | USD |
| Honduras | +504 | HNL |
| Costa Rica | +506 | CRC |
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:
| HTTP | error.code | Cuándo |
|---|---|---|
| 400 | 5000 | Params faltantes o inválidos (amount, channel, client, userId, customKeys, processor) |
| 400 | — | processor no permitido para este cliente |
| 400 | 5004 | Config del cliente no encontrada |
| 400 | 2002 | Falló la creación de la transacción |
| 400 | 2003 | Monto fuera del rango permitido |
Consulta el Catálogo de errores para la descripción completa de cada código.
Relacionado
- Recetas de integración — matriz país × rail
- Guatemala — el mismo rail junto a Zigi, Akisi, Banco Industrial, BAM y Pronet
- Métodos de pago disponibles — catálogo filtrado por país