Ir al contenido

Pruebas y checklist

Son cinco pasos, y son el camino feliz completo: crear un cobro, pagarlo, enterarte por webhook, recibir de vuelta a quien pagó y encontrarlo en la conciliación. Si eso funciona, tu integración funciona.

No te pedimos que provoques errores. Los casos raros son responsabilidad nuestra: cada error trae un code estable y ese código está explicado en Errores, con qué hacer en cada caso. Si alguno no se entiende, dínoslo — es un problema de nuestra documentación, no tuyo.

Cada paso tiene un identificador entre corchetes. Los usamos al revisar tus pruebas, así que si algo falta te vamos a decir “falta webhook” y no un párrafo.

  • sesion — Crea una sesión con POST /v1/checkout-sessions, con tu Idempotency-Key, y guarda el session_id y el checkout_url que te devuelve.
  • pago — Abre ese checkout_url en un navegador, entra con el correo de tu equipo, guarda la tarjeta de prueba aprobada y paga. Ver Alta de tu comercio para las tarjetas.
  • webhook — Recibe payment.succeeded en tu URL de webhook, verifica la firma antes de hacer nada, y marca como pagada la obligación de resource.external_reference. Ver Verificar la firma.
  • retorno — Comprueba que quien pagó vuelve a tu página de retorno, y que tu sitio no marca la obligación como pagada solo porque llegó ahí: el webhook es la fuente. Ver Redirección y regreso.
  • conciliacion — Descarga GET /v1/reconciliation/payments.csv y encuentra ese pago por su payment_id. Ver Archivo CSV.

Estas no las podemos ver en tu tráfico, así que te las preguntamos:

  • Tu API key y tu webhook_secret viven en el gestor de secretos de tu infraestructura, no en código fuente ni en variables de un CI compartido.
  • Tienes un contacto técnico designado para incidentes y para rotar credenciales.

Escríbenos con tu provider_id, la fecha en que hiciste las pruebas y el correo con el que entraste a pagar. Revisamos tu tráfico del ambiente de pruebas y confirmamos los cinco pasos. Si falta alguno te decimos cuál.

Después de eso te entregamos la API key de producción. Ver Alta de tu comercio.