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:
Campo | Tipo | Descripción |
---|---|---|
country | string | Código de país alfa-3 ISO 3166-1 (p. ej., COL para Colombia, USA para Estados Unidos). |
origin | string | Origen de la solicitud, debe establecerse en api . |
amount | string | Importe total a pagar, representado como un número entero sin decimales (p. ej., 1000 ). |
email | string | Direcció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"
}
}