Ir al contenido

Introducción

Nuevo: Puedes realizar pruebas en vivo de nuestra APIPrueba

Bienvenido a la API de payku. Puedes usar nuestra API para acceder a los distintos endpoints de payku, donde podrás generar y gestionar pagos mediante distintos métodos y obtener información de ellos.

El API está organizado alrededor de REST. Posee URLs predecibles y orientadas a recursos, y utiliza códigos de respuesta HTTP para indicar el resultado de la llamada. Todas las respuestas de la API retornan objetos JSON, incluyendo los errores.

El solicitante debe buscar un código de resultado 200. Si se recibe cualquier código de resultado distinto de 200, la solicitud o la respuesta no es válida, lo que significa que los campos no pasaron los controles de validación de parte de payku. Utilizamos características incluidas en el protocolo HTTP, como autenticación, los cuales son soportados por la gran mayoría de los clientes HTTP.

Importante — ¿Cómo saber si una operación falló?

No te fíes solo del código HTTP (por ejemplo, 200). En nuestra API, muchas respuestas con error también llegan con código HTTP 200. Esto es intencional y forma parte del diseño de la API.

Siempre revisa el contenido JSON de la respuesta y busca el campo status:

  • Si status es "success", la operación se realizó correctamente.
  • Si status es "failed", hubo un error (por ejemplo, datos inválidos o una operación rechazada). Revisa también el mensaje de error que venga en la misma respuesta.