Pagos API

La API de Pagos te permite gestionar los pagos en tu aplicación.

Endpoints

POST /payment/
GET /payments/:id

POST /payments/

Este endpoint crea un nuevo pago.

Request

El body del request debe incluir los siguientes campos:

Campo	Tipo	Descripción	Requerido
price	object	El precio en la moneda especificada.	Si
user_id	string	El ID del usuario que está creando el pago.	Si
webhook_url	string	La URL para notificar el estado del pago.	No
redirect_url	string	La URL a la que se redirigirá al usuario después de completar el pago.	Si
external_id	string	El ID del pago en el sistema de comercio.	Si
motive	string	El mensaje que se mostrará al pagar para indicar qué producto se está pagando.	No
items	array	Un array de items que se desean comprar.	No

Response

La respuesta incluye el siguiente formato:

Campo	Tipo	Descripción
message	string	Mensaje de respuesta.
error	bool	Indica si hubo error o no.
data	object	Objeto con la información del pago.

Ejemplos de uso

curl -X POST https://api.talo.com.ar/payments/ \
-H 'Content-Type: application/json' \
-d '{
    "price": {
        "currency": "ARS",
        "amount": 1500
    },
    "user_id": "32392bb0-ae84-4fd5-8d2c-20a8fa51cad8",
    "redirect_url": "fabricadefotolibros.com/checkout/1234",
    "motive": "2 calendarios grandes",
    "external_id": "FDF_987654"
}'

GET /payments/:id

Este endpoint obtiene la información de un pago específico.

Request

Parámetro URL:

Parámetro	Descripción
:id	El ID del pago.

Response

La respuesta incluye el siguiente formato:

Campo	Tipo	Descripción
message	string	Mensaje de respuesta.
error	bool	Indica si hubo error o no.
data	object	Objeto con la información del pago.

Ejemplos de uso

# Curl
curl -H "Authorization: Bearer {access_token}"
 -X GET https://api.talo.com.ar/payments/32392bb0-ae84-4fd5-8d2c-20a8fa51cad8

Códigos de Estado de Pago

Código	Descripción
PENDING	Pago pendiente
SUCCESS	Pago exitoso
REJECTED	Pago rechazado
CANCELLED	Pago cancelado
UNDER_REVIEW	Pago en revisión

Autenticación Usuarios