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.
Los cinco pasos
Sección titulada «Los cinco pasos»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 conPOST /v1/checkout-sessions, con tuIdempotency-Key, y guarda elsession_idy elcheckout_urlque te devuelve. -
pago— Abre esecheckout_urlen 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— Recibepayment.succeededen tu URL de webhook, verifica la firma antes de hacer nada, y marca como pagada la obligación deresource.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— DescargaGET /v1/reconciliation/payments.csvy encuentra ese pago por supayment_id. Ver Archivo CSV.
Dos cosas que revisamos y no dejan rastro
Sección titulada «Dos cosas que revisamos y no dejan rastro»Estas no las podemos ver en tu tráfico, así que te las preguntamos:
- Tu API key y tu
webhook_secretviven 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.
Cuando termines
Sección titulada «Cuando termines»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.