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": 50,
    "tip": 0,
    "extra_taxes": {
      "airport_tax": 0,
      "iac": 0,
      "ice": 0,
      "travel_agency": 0
    }
  }
}

Para el ejemplo anterior (total = 50.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

Autorización

Monto (MXN)	Código de respuesta (F39)	Descripción
`10`	`01`	Transacción rechazada — el tarjetahabiente debe contactar al emisor de su tarjeta.
`30`	`03`	Bloqueo temporal.
`40`	`04`	La tarjeta fue reportada. El tarjetahabiente debe usar otra tarjeta.
`50`	`05`	Do not honor — ocurrió un error al procesar la transacción.
`74`	`00`	Aprobada con demora — transacción aprobada tras una demora (simula una respuesta lenta del procesador).
`175.01`	`Z5`	Cuenta válida, pero el monto no es compatible (rechazo suave).
`175.02`	`5C`	Transacción no compatible o bloqueada por el emisor (rechazo suave).
`175.03`	`9G`	Bloqueada por el tarjetahabiente; contacta al tarjetahabiente (rechazo suave).
Cualquier otro monto	`00`	Aprobada — respuesta de aprobación estándar.

Anulación y reverso

Monto (MXN)	Código de respuesta (F39)	Descripción
`20.1`	`01`	Transacción rechazada — el tarjetahabiente debe contactar al emisor de su tarjeta.
`20.4`	`04`	La tarjeta fue reportada. El tarjetahabiente debe usar otra tarjeta.
`20.5`	`05`	Do not honor — ocurrió un error al procesar la transacción.
`174`	`00`	Aprobada con demora — transacción aprobada tras una demora.

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 174 MXN para probar los flujos de anulación y reverso con una respuesta de aprobación con demora. Los montos 20.1, 20.4 y 20.5 simulan anulaciones rechazadas (consulta la tabla Anulación y reverso de arriba).

{
  "transaction_type": "charge",
  "transaction_mode": "Void",
  "amount": {
    "currency": "MXN",
    "subtotal_iva": 0,
    "subtotal_iva0": 174,
    "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#

Autorización#

Anulación y reverso#

Pruebas de MSI (Meses Sin Intereses)#

Pruebas de anulación y reverso#

Ambientes#

Cómo funciona

Montos de prueba de México

Autorización

Anulación y reverso

Pruebas de MSI (Meses Sin Intereses)

Pruebas de anulación y reverso

Ambientes