🔁 Transfers API

Crea un pago único por transferencia bancaria y obtén un CVU/alias exclusivo para esa orden.

Endpoint

Prod

POST https://api.talo.com.ar/payments/

Sandbox

POST https://sandbox-api.talo.com.ar/payments/

Campos requeridos

Campo	Tipo	Descripción
`user_id`	`string`	ID de tu cuenta Talo (sandbox o producción)
`price.amount`	`number`	Monto en pesos
`price.currency`	`"ARS"`	Solo ARS para transferencias
`payment_options`	`string[]`	Incluir `"transfer"`
`external_id`	`string`	ID único de tu orden
`webhook_url`	`string`	URL donde recibirás notificaciones

Campos opcionales

Campo	Tipo	Descripción
`redirect_url`	`string`	A dónde volvemos al cliente al terminar el pago
`motivo`	`string`	Motivo del pago

Ejemplo de solicitud

curl -X POST https://sandbox-api.talo.com.ar/payments/ \
  -H "Authorization: Bearer $TALO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "f61876b0-10a5-4e39-8e2c-17343b3fa1b6",
    "price": { "amount": 30000, "currency": "ARS" },
    "payment_options": ["transfer"],
    "external_id": "ORDER_123",
    "webhook_url": "https://tu-sitio.com/webhooks/talo"
  }'

Respuesta

{
	data: {
		id: "VAR-f61876b0-FDF_124", // ID interno de Talo
		payment_status: "PENDING",
		quotes: [
			{
				cvu: "0000630500000060195375",
				alias: "talo.ago.1468",
			},
		],
		payment_url: "https://talo.com.ar/payments/VAR-f618...",
		expiration_timestamp: "2024-09-02T14:00:15.411Z",
	},
}

Muestra al cliente el cvu o alias, o simplemente redirígelo a payment_url.

Estados del pago

Estado	Descripción
`PENDING`	Esperando transferencia
`SUCCESS`	Se acreditó el monto exacto
`OVERPAID`	Se recibió más de lo solicitado
`UNDERPAID`	Se recibió menos
`EXPIRED`	El CVU venció (~5 días)

Para OVERPAID y UNDERPAID, decide si aceptas la orden o emites reembolso manual.

Simular pago en sandbox

POST https://sandbox-api.talo.com.ar/cvu/{cvu}/faucet

Parámetros del path

Campo	Tipo	Descripción
`cvu`	`string`	CVU donde recibir el pago

Parámetros del body

Campo	Tipo	Descripción
`amount`	`number`	Monto a simular

Ejemplo de simulación

curl -X POST \
  "https://sandbox-api.talo.com.ar/cvu/0000630500000060195375/faucet" \
  -H "Authorization: Bearer $TALO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 30000 }'

Payload del webhook:

{
	"message": "Pago Actualizado",
	"paymentId": "VAR-f61876b0-FDF_124",
	"externalId": "ORDER_123"
}

Consultar un pago

GET https://sandbox-api.talo.com.ar/payments/{paymentId}

Parámetros del path

Campo	Tipo	Descripción
`paymentId`	`string`	ID interno de Talo del pago

Campos de la respuesta

Campo	Tipo	Descripción
`payment_status`	`string`	Estado del pago
`payment_url`	`string`	URL para completar el pago
`expiration_timestamp`	`string`	Fecha de vencimiento
`quotes[0].address`	`string`	CVU para transferir
`quotes[0].alias`	`string`	Alias de la cuenta
`price.amount`	`number`	Monto en pesos
`price.currency`	`string`	Moneda
`payment_options`	`string[]`	Métodos de pago
`external_id`	`string`	ID de la orden
`webhook_url`	`string`	URL de webhook
`redirect_url`	`string`	URL de redirección
`motivo`	`string`	Motivo del pago
`transaction_fields`	`object`	Campos de la transacción. Presente una vez que se haya realizado el pago.
`transactions`	`object[]`	Transacciones. Presente una vez que se haya recibido alguna transferencia para el pago.

Ejemplo de consulta

curl -H "Authorization: Bearer $TALO_TOKEN" \
  https://sandbox-api.talo.com.ar/payments/VAR-f61876b0-FDF_124

Ejemplo de respuesta

{
	"message": "ok",
	"error": false,
	"code": 200,
	"data": {
		"price": {
			"amount": 30000,
			"currency": "ARS"
		},
		"creation_timestamp": "2024-08-28T14:00:15.411Z",
		"last_modified_timestamp": "2024-08-28T14:00:15.411Z",
		"user_id": "f61876b0-10a5-4e39-8e2c-17343b3fa1b6",
		"external_id": "FDF_124",
		"redirect_url": "https://example.com/payment/123",
		"webhook_url": "https://example.com/webhooks/payments",
		"quotes": [
			{
				"currency": "ARS",
				"network": "POLLUX",
				"amount": "30000",
				"amountReadable": "30000",
				"address": "0000630500000060195375",
				"alias": "talo.ago.1468"
			}
		],
		"is_deleted": false,
		"payment_status": "SUCCESS",
		"id": "VAR-f61876b0-10a5-4e39-8e2c-17343b3fa1b6-FDF_124",
		"user_info": {
			"email": "example@example.com",
			"fiat_payments_enabled": false,
			"payment_notifications": false,
			"user_id": "f61876b0-10a5-4e39-8e2c-17343b3fa1b6",
			"payment_url": "https://d3e9ln1d0tu6ol.cloudfront.net/payments/VAR-f61876b0-10a5-4e39-8e2c-17343b3fa1b6-FDF_124",
			"payment_options": ["transfer"],
			"provider": "email",
			"expiration_timestamp": "2024-09-02T14:00:15.411Z",
			"transactions": [
				{
					"address": "0000630500000060195375",
					"amount": "30000",
					"commission": 0.605,
					"commission_amount": "1053.51",
					"commission_taxes": [
						{
							"tax_amount": 6.3210641999999995,
							"tax_rate": 0.6,
							"tax_type": "DEBIT"
						}
					],
					"commission_tax_amount": "6.32",
					"creation_timestamp": "2025-03-12T03:35:32.405Z",
					"credited_amount": "172029.37",
					"currency": "ARS",
					"network": "POLLUX",
					"sender_address": "00000031123456789",
					"taxes": [
						{
							"tax_amount": 1044.8039999999999,
							"tax_rate": 0.6,
							"tax_type": "CREDIT"
						}
					],
					"tax_amount": "1044.80",
					"transaction_data": {
						"PROCESSED": {
							"amount": 30000,
							"currency": "ARS",
							"recipient": "0000630500000060195375",
							"recipientCuit": "30123456789",
							"recipientTitular": "EXAMPLE SA",
							"sender": "00000031123456789",
							"senderCuit": "20997654321",
							"senderTitular": "Carolina Perez",
							"trxId": "1b5a952a-8a79-4003-b06a-e4043d453456"
						}
					}
				}
			]
		},
		"transaction_fields": {
			"amount": "30000",
			"amountReadable": "30000",
			"commission_amount": "1053.51",
			"credited_amount": "172029.37",
			"currency": "ARS",
			"network": "POLLUX",
			"total_paid": {
				"amount": "30000",
				"currency": "ARS"
			}
		}
	}
}

UX recomendado

Temporizador: muestra cuenta regresiva hasta expiration_timestamp.
Copy‑to‑clipboard: botón para copiar CVU y alias.
Botón “Abrir Home Banking” (link a apps comunes) para acelerar la transferencia.

Lista para pasar a cuentas permanentes? Lee Customers API →

Introducción Customers API