API · Create payment link
API v1POST /api/v1/createLinkPaymentWhat it does#
Creates a payment link with amount, currency and usage behaviour.
Authentication#
Requires the API bearer token in the Authorization header — see authentication.
Parameters#
Tilopay integration key.
Amount of the payment link.
Currency code in ISO 4217 format.
Reference of the payment link.
Link type: 0 unlimited, 1 single use.
Payment description.
Customer name. It only applies when type is 1.
Optional field. URL, over GET, the customer is redirected to with the response once the payment is completed. Example of the data sent: code=Val&description=Val&auth=Val&tilopayLinkId=Val&orderNumber=Val&tilopayOrderId=Val&creditCardToken=Val&creditCardBrand=Val&last4CreditCardNumber=Val&orderHash=Val
Optional field. URL to send the response webhook to once the payment is completed. It must accept the POST method to receive the data. Example of the data sent:
{
"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": ""
}Request example#
The <...> values are placeholders: replace them with your own credentials and data.
{
"key": "<api_key>",
"amount": "10",
"currency": "USD",
"reference": "123456",
"type": 0,
"description": "Description",
"client": "Client name",
"callback_url": "",
"webhook_url": ""
}Response#
{
"type": "200",
"message": "Success",
"url": "https://app.tilopay.com/link/MjMwMjQ=",
"id": 1
}To interpret a response that is not a success, see how to read an error response.
Last verified: 2026-08-29 · Owner: equipo-integraciones