Saltar al contenido principal

Crear una orden

Genere una solicitud de pago en la plataforma 88 Pay y reciba un hash único como respuesta. Este hash se incluirá en el cuerpo de una solicitud de punto final posterior para completar la transacción.

¿Cómo generar el orden?

Detalles de la solicitud

  • Método: Post
  • URL:
https://b61cr11gvd.execute-api.us-east-1.amazonaws.com/v1/api/payment/create

Encabezados

Incluya los siguientes encabezados en su solicitud:

"Authorization": "token" // Token generado para la autorización de API

Cuerpo de la solicitud

La carga útil de la solicitud debe estructurarse de la siguiente manera:

CampoTipoDescripción
countrystringCódigo de país alfa-3 ISO 3166-1 (p. ej., COL para Colombia, USA para Estados Unidos).
originstringOrigen de la solicitud, debe establecerse en api.
amountstringImporte total a pagar, representado como un número entero sin decimales (p. ej., 1000).
emailstringDirección de correo electrónico del cliente

Ejemplo de Solicitud

{
"country": "COL",
"origin": "api",
"amount": "1000",
"email": "test@gmail.com"
}

Ejemplo de Respuesta

202 Pago aceptado creado

{
"status": {
"code": 202,
"message": "success",
"kind": "unknown"
},
"data": {
"hash": "U2FsdGV....__hash-payment"
}
}

422 Entidad no procesable

El cuerpo enviado no es correcto

{
"status": {
"code": 422,
"message": "[\n {\n \"code\": \"invalid_type\",\n \"expected\": \"string\",\n \"received\": \"undefined\",\n \"path\": [\n \"amount\"\n ],\n \"message\": \"amount is required\"\n }\n]",
"kind": "validation"
}
}

401 Encabezado no autorizado

No se envió el token

{
"status": {
"code": "token/not-found",
"kind": "client",
"name": "TokenNotFoundError"
}
}

401 Token no autorizado (malformación)

El token enviado es incorrecto o está vencido.

{
"status": {
"code": "security/unauthorized-error",
"kind": "client",
"name": "UnauthorizedError"
}
}