Create a payment link
Creates a payment link in the live or test mode of the API key used. The response includes the url of the page where your customer pays. The payment link accepts payments until you cancel it or, when expires_after_seconds is sent, until it expires.
v1 · Base URL https://api.fintoc.com/v1Autorizaciones
Cuerpo
Amount to collect, in the smallest unit of currency. For example, 5000 represents 5000 CLP, since CLP has no minor unit, or 50.00 MXN. Must be greater than 0.
5000
Three-letter ISO 4217 currency code. One of CLP (Chilean peso) or MXN (Mexican peso). Case-insensitive.
CLP, MXN "CLP"
Required if your organization identifies a business profile per payment. Enrolled merchant on whose behalf you collect the payment, used for category-based billing.
Checkout customization. Supports a single description key.
Email address of your customer, used for transaction notifications, including refunds.
"customer@example.com"
Number of seconds after which the payment link expires. Must be greater than 0. If omitted, the payment link never expires.
86400
Set of key-value pairs you can attach to the payment link to store additional information in a structured format.
Required if your organization uses the Fintoc Reconciles schema without a default pool account. Destination bank account for the payments collected with the link. Available only in Chile. Do not send it if your organization uses Fintoc Collects, where Fintoc presets the account for you.
Respuesta
Payment link created. Share the returned url with your customer to collect the payment.
Unique identifier of the payment link.
"plink_K2zwNNSxPyx8w3GZ"
Type of the object. Always payment_link.
Amount to collect, in the smallest unit of currency. For example, 5000 represents 5000 CLP, since CLP has no minor unit, or 50.00 MXN.
5000
Checkout customization. The description key holds the text shown next to the buy button, or null when you do not set it.
ISO 8601 datetime in UTC of when the payment link was created.
"2024-04-04T15:23:11.474Z"
Three-letter ISO 4217 currency code. One of CLP (Chilean peso) or MXN (Mexican peso).
CLP, MXN "CLP"
Email address of your customer, used for transaction notifications. null when not provided on creation.
"customer@example.com"
ISO 8601 datetime in UTC of when the payment link expires. null when the payment link does not expire.
"2024-04-05T15:23:11.474Z"
Set of key-value pairs attached to the payment link on creation.
Mode of the object. live objects use real institution data, test objects use fake data for integration testing.
test, live "live"
Destination bank account for the payments collected with the link. null unless your organization sent it on creation.
Status of the payment link. One of active (accepts payments), expired (the expiration date passed), or canceled (you canceled the link).
active, expired, canceled "active"
URL of the page where your customer pays.
"https://pay.fintoc.com/plink_K2zwNNSxPyx8w3GZ"