Saltar al contenido principal
POST
Create a payment intent
v2 · Base URL https://api.fintoc.com/v2

Autorizaciones

Authorization
string
header
requerido

Cuerpo

application/json
amount
integer
requerido

Amount to charge, 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. Must be greater than zero and at most 2147483647.

Ejemplo:

5000

currency
enum<string>
requerido

Three-letter ISO 4217 currency code, in uppercase. One of CLP or MXN.

Opciones disponibles:
CLP,
MXN
Ejemplo:

"CLP"

payment_method
string
requerido

The id of the payment method to charge. The payment method must belong to your organization and match the mode of the API key used.

Ejemplo:

"pm_2bArifJWQ6CiZSofWxBNL1Hri2u"

metadata
object

Set of key-value pairs to attach to the payment intent. Up to 50 pairs, with keys of up to 40 characters and values of up to 500 characters. Nested objects and arrays are not allowed.

Ejemplo:

Respuesta

Payment intent created. The charge starts in the created status; Fintoc processes the charge asynchronously.

id
string
requerido

Unique identifier of the payment intent.

Ejemplo:

"pi_2cKoy3PEXAuvkr4ofXC1KdMvCgZ"

object
any
requerido

Type of the object. Always payment_intent.

amount
integer
requerido

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.

Ejemplo:

5000

created_at
string<date-time>
requerido

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

Ejemplo:

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

currency
enum<string>
requerido

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

Opciones disponibles:
CLP,
MXN
Ejemplo:

"CLP"

customer
object | null
requerido

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
requerido

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

Ejemplo:

"customer@example.com"

error_reason
string | null
requerido

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

Ejemplo:

null

expires_at
string<date-time> | null
requerido

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

Ejemplo:

null

metadata
object
requerido

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

Ejemplo:
mode
enum<string>
requerido

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

Opciones disponibles:
live,
test
Ejemplo:

"live"

next_action
object | null
requerido

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.

Ejemplo:

null

payment_method
string | null
requerido

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

Ejemplo:

"pm_2bArifJWQ6CiZSofWxBNL1Hri2u"

payment_type
string
requerido

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.

Ejemplo:

"bank_transfer"

payment_type_options
object
requerido

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.

Ejemplo:
recipient_account
object | null
requerido

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
requerido

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

Ejemplo:

"90123712"

sender_account
object | null
requerido

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

status
enum<string>
requerido

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.

Opciones disponibles:
created,
failed,
succeeded,
rejected,
in_progress,
pending,
expired
Ejemplo:

"succeeded"

subscription
string | null
requerido

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

Ejemplo:

null

transaction_date
string<date-time> | null
requerido

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

Ejemplo:

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

widget_token
string | null
requerido

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

Ejemplo:

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.