Pagos API

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

Endpoints

POST /payment/
GET /payments/:id
PUT /payments/:id/price

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

PUT /payments/:id/price

Este endpoint requiere un token de acceso válido.

Este endpoint actualiza el precio de un pago específico.

Si el pago está en estado PENDING, se actualizará el precio del pago.

Si el pago está en estado SUCCESS, OVERPAID o UNDERPAID, se actualizará el precio del pago y se calculará el nuevo estado de pago basado en el nuevo precio. Si hubiera una modificación en el estado, se enviará una notificación al webhook configurado.

Si el pago que se intenta actualizar está en estado EXPIRED, se devolverá un error.

Request

Parámetro URL:

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

El body del request debe incluir los siguientes campos:

Campo	Tipo	Descripción	Requerido
currency	string	Código de moneda. Por el momento solo se soporta ARS.	Si
amount	number	Monto nuevo del pago en la moneda especificada.	Si

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 PUT https://api.talo.com.ar/payments/32392bb0-ae84-4fd5-8d2c-20a8fa51cad8/price
 -H 'Content-Type: application/json'
 -d '{
    "currency": "ARS",
    "amount": 1500
}'

Autenticación Usuarios