Datos de prueba

Usa estos montos de prueba en el ambiente sandbox (UAT) para simular resultados específicos de transacción al integrar los pagos presenciales en México.

Cómo funciona

Para disparar un escenario específico, envía el monto en MXN correspondiente como total del objeto amount (subtotal_iva0 en transacciones sin impuestos). La suma de todos los valores dentro del objeto amount determina qué escenario se dispara.

{
  "amount": {
    "currency": "MXN",
    "iva": 0,
    "subtotal_iva": 0,
    "subtotal_iva0": 5,
    "tip": 0,
    "extra_taxes": {
      "airport_tax": 0,
      "iac": 0,
      "ice": 0,
      "travel_agency": 0
    }
  }
}

Para el ejemplo anterior (total = 5.00 MXN), recibirás:

{
  "kushki_response": {
    "code": "05",
    "message": "Do not honor"
  },
  "transaction_status": "DECLINED",
  "transaction_reference": "0c598cc7-bfd5-4180-8544-34a4f923086e"
}

INFO

La respuesta del escenario de prueba se ve en el campo kushki_response de la respuesta de la API.

Montos de prueba de México

Monto (MXN)	Código de respuesta	Descripción
`1`	`01`	Transacción rechazada — el tarjetahabiente debe contactar al emisor de su tarjeta.
`3`	`03`	Comercio inválido.
`4`	`04`	La tarjeta fue reportada (retenida). El tarjetahabiente debe usar otra tarjeta.
`5`	`05`	Do not honor — ocurrió un error al procesar la transacción.
`7.40`	`00`	Aprobada con demora — transacción aprobada tras una demora (simula una respuesta lenta del procesador).
`17.40`	`00`	Aprobada con demora — úsalo para las pruebas de anulación y reverso.
Cualquier otro monto	`00`	Aprobada — respuesta de aprobación estándar.

Pruebas de MSI (Meses Sin Intereses)

Para probar escenarios de MSI, usa cualquier monto aprobado (que no esté en la tabla de errores anterior) que cumpla el monto mínimo de MSI e incluye el objeto deferred:

{
  "amount": {
    "currency": "MXN",
    "subtotal_iva": 0,
    "subtotal_iva0": 600,
    "iva": 0
  },
  "is_deferred": true,
  "deferred": {
    "months": "6"
  }
}

INFO

Montos mínimos para las pruebas de MSI: 3 meses → 600 MXN, 9 meses → 1,200 MXN, 18 meses → $1,800 MXN.

Pruebas de anulación y reverso

Usa el monto 17.40 MXN para probar los flujos de anulación y reverso con una respuesta de aprobación con demora.

{
  "transaction_type": "charge",
  "transaction_mode": "Void",
  "amount": {
    "currency": "MXN",
    "subtotal_iva": 0,
    "subtotal_iva0": 17.40,
    "iva": 0
  },
  "transaction_reference": "<reference-from-original-charge>"
}

Ambientes

🧪 Sandbox (UAT)

https://api-uat.kushkipagos.com/

Usa este ambiente para todas las pruebas en sandbox. Tus credenciales Private-Merchant-Id de UAT son distintas de las de producción.

¿Tienes una sugerencia sobre esta documentación? Contáctanos.

Cómo funciona#

Montos de prueba de México#

Pruebas de MSI (Meses Sin Intereses)#

Pruebas de anulación y reverso#

Ambientes#

Cómo funciona

Montos de prueba de México

Pruebas de MSI (Meses Sin Intereses)

Pruebas de anulación y reverso

Ambientes