API · Crear link de pago
API v1POST /api/v1/createLinkPaymentQué hace#
Crea un link de pago con monto, moneda y comportamiento de uso.
Autenticación#
Requiere el token bearer del API en el header Authorization — ver autenticación.
Parámetros#
Key de la integración Tilopay.
Monto para el link de pago.
Código de moneda en formato ISO 4217.
Referencia del link de pago.
Tipo de link: 0 ilimitado, 1 de un solo uso.
Descripción del pago.
Nombre del cliente, aplica solo cuando type es 1.
Campo opcional. URL, por método GET, a la que se redirige con la respuesta al completar el pago. Ejemplo de los datos enviados: code=Val&description=Val&auth=Val&tilopayLinkId=Val&orderNumber=Val&tilopayOrderId=Val&creditCardToken=Val&creditCardBrand=Val&last4CreditCardNumber=Val&orderHash=Val
Campo opcional. URL para enviar el webhook de respuesta al completar el pago. Debe ser de método POST para que reciba los datos. Ejemplo de los datos enviados:
{
"code": "1",
"codeDescription": "Aprobada",
"auth": "123456",
"tilopayLinkId": 54421,
"orderNumber": "TPT123",
"tilopayOrderId": 12233,
"creditCardToken": "41111******11111",
"creditCardBrand": "Visa",
"last4CreditCardNumber": "1111",
"linkDescription": "Descripcion del link de pago",
"orderHash": ""
}Ejemplo de request#
Los valores <...> son marcadores: reemplazalos por tus credenciales y datos.
{
"key": "<api_key>",
"amount": "10",
"currency": "USD",
"reference": "123456",
"type": 0,
"description": "Description",
"client": "Client name",
"callback_url": "",
"webhook_url": ""
}Respuesta#
{
"type": "200",
"message": "Success",
"url": "https://app.tilopay.com/link/MjMwMjQ=",
"id": 1
}Para interpretar una respuesta que no es de éxito, ver cómo leer una respuesta de error.
Última verificación: 2026-08-29 · Responsable: equipo-integraciones