Saltar al contenido principal
GET
List payment links
v1 · Base URL https://api.fintoc.com/v1

Autorizaciones

Authorization
string
header
requerido

Parámetros de consulta

since
string<date>

ISO 8601 date or datetime. Limits the list to payment links created at or after this date.

Ejemplo:

"2024-04-04"

until
string<date>

ISO 8601 date or datetime. Limits the list to payment links created at or before this date.

Ejemplo:

"2024-04-05"

page
integer<int32>

Page number to retrieve. Starts at 1.

per_page
integer<int32>

Number of payment links per page. Defaults to 30. The maximum is 300.

Respuesta

List of payment links for the current mode. The Link header contains the URLs of the surrounding pages, and X-Total-Count contains the total number of payment links.

id
string
requerido

Unique identifier of the payment link.

Ejemplo:

"plink_K2zwNNSxPyx8w3GZ"

object
any
requerido

Type of the object. Always payment_link.

amount
integer
requerido

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.

Ejemplo:

5000

checkout
object
requerido

Checkout customization. The description key holds the text shown next to the buy button, or null when you do not set it.

Ejemplo:
created_at
string<date-time>
requerido

ISO 8601 datetime in UTC of when the payment link was created.

Ejemplo:

"2024-04-04T15:23:11.474Z"

currency
enum<string>
requerido

Three-letter ISO 4217 currency code. One of CLP (Chilean peso) or MXN (Mexican peso).

Opciones disponibles:
CLP,
MXN
Ejemplo:

"CLP"

customer_email
string | null
requerido

Email address of your customer, used for transaction notifications. null when not provided on creation.

Ejemplo:

"customer@example.com"

expires_at
string<date-time> | null
requerido

ISO 8601 datetime in UTC of when the payment link expires. null when the payment link does not expire.

Ejemplo:

"2024-04-05T15:23:11.474Z"

metadata
object
requerido

Set of key-value pairs attached to the payment link on creation.

Ejemplo:
mode
enum<string>
requerido

Mode of the object. live objects use real institution data, test objects use fake data for integration testing.

Opciones disponibles:
test,
live
Ejemplo:

"live"

recipient_account
object | null
requerido

Destination bank account for the payments collected with the link. null unless your organization sent it on creation.

status
enum<string>
requerido

Status of the payment link. One of active (accepts payments), expired (the expiration date passed), or canceled (you canceled the link).

Opciones disponibles:
active,
expired,
canceled
Ejemplo:

"active"

url
string
requerido

URL of the page where your customer pays.

Ejemplo:

"https://pay.fintoc.com/plink_K2zwNNSxPyx8w3GZ"