Skip to main content
GET
List payment intents
v2 · Base URL https://api.fintoc.com/v2

Authorizations

Authorization
string
header
required

Query Parameters

ending_before
string

Cursor for pagination. The id of a payment intent; the response only includes payment intents created after that payment intent. Cannot be used together with starting_after.

limit
integer

Number of payment intents to return per page. Defaults to 30, with a maximum of 300.

starting_after
string

Cursor for pagination. The id of a payment intent; the response only includes payment intents created before that payment intent. Cannot be used together with ending_before.

Response

A list of your payment intents for the current mode. The Link response header contains the URL of the next page, if any.

id
string
required

Unique identifier of the payment intent.

Example:

"pi_2cKoy3PEXAuvkr4ofXC1KdMvCgZ"

object
any
required

Type of the object. Always payment_intent.

amount
integer
required

Amount of the payment intent, in the smallest unit of the currency. CLP has no decimals, so 5000 is $5000 CLP; MXN amounts are expressed in centavos, so 5000 is $50.00 MXN.

Example:

5000

created_at
string<date-time>
required

Time the payment intent was created, as an ISO 8601 datetime in UTC.

Example:

"2026-02-10T15:23:11Z"

currency
enum<string>
required

Three-letter ISO 4217 currency code, returned in uppercase (for example, CLP or MXN).

Available options:
CLP,
MXN
Example:

"CLP"

customer
object | null
required

Customer associated with the payment intent. Present when the payment intent was created from a checkout session with an associated customer; null otherwise.

customer_email
string | null
required

Email collected from the customer at payment time, when available. May differ from customer.email.

Example:

"customer@example.com"

error_reason
string | null
required

Reason why the payment failed. null unless the payment finished unsuccessfully.

Example:

null

expires_at
string<date-time> | null
required

Time the payment intent expires, as an ISO 8601 datetime in UTC. null when the payment intent does not expire.

Example:

null

metadata
object
required

Set of key-value pairs attached to the payment intent at creation. Defaults to an empty object.

Example:
mode
enum<string>
required

Mode of the payment intent. live for real payments, test for payments created with a test API key.

Available options:
live,
test
Example:

"live"

next_action
object | null
required

Action the customer must complete for the payment to continue, for example confirming the payment in their banking app. The type key indicates the kind of action. null when no action is pending.

Example:

null

payment_method
string | null
required

Identifier of the payment method associated with the payment intent, when available.

Example:

"pm_2bArifJWQ6CiZSofWxBNL1Hri2u"

payment_type
string
required

Type of payment that produced this payment intent, for example bank_transfer, cash, card, installment, pac, or a provider-specific external redirect such as banco_estado. The value depends on how the payment was initiated.

Example:

"bank_transfer"

payment_type_options
object
required

Additional options specific to the payment type. For card payments, the object contains a card object. The object is empty when the payment type has no extra options.

Example:
recipient_account
object | null
required

Bank account that received the payment. null when the payment is not associated with a recipient account, for example for charges on a saved payment method.

reference_id
string | null
required

Identifier given by the institution that processed the payment, when available.

Example:

"90123712"

sender_account
object | null
required

Bank account that sent the payment. null when the sender account is unknown.

status
enum<string>
required

Status of the payment intent. One of created (the charge was accepted and is awaiting processing), in_progress (Fintoc is processing the charge), succeeded (the charge completed), failed (the charge did not complete), rejected (the institution rejected the charge), expired (the payer did not act in time), or pending (the final status is not yet known). pending is only returned to organizations that have the pending status enabled.

Available options:
created,
failed,
succeeded,
rejected,
in_progress,
pending,
expired
Example:

"succeeded"

subscription
string | null
required

Identifier of the subscription that originated the payment intent, when the payment was created from a subscription invoice. null otherwise.

Example:

null

transaction_date
string<date-time> | null
required

Time the institution processed the payment, as an ISO 8601 datetime in UTC. null when not available.

Example:

"2026-02-10T15:24:15Z"

widget_token
string | null
required

Token used by the Fintoc widget to resume a customer-present flow. Always null for payment intents returned by the v2 API.

Example:

null

business_profile
object | null

Business information of the entity that receives the payment, when it was collected on behalf of a business. null when no business information was provided.