Sign in

v1

latestOpenAPI 3.1.02026-07-228956435.8 KB
Payment intents

Check payment eligibility

Checks whether a payment for the given amount and sender account passes the transfer limits that banks and Fintoc enforce, without creating a payment intent. Only available for CLP payments. Available for organizations on API version 2026-02-01 or later.

post/payment_intents/check_eligibility

Request body

amountinteger required

A positive integer representing the amount to pay, in the smallest unit of the currency (for example, 100000 for 100000 CLP, since CLP has no minor unit).

currencystring required

Three-letter ISO 4217 currency code. Only CLP is supported.

Example request

{
  "amount": 100000,
  "currency": "CLP",
  "sender_account": {
    "institution_id": "cl_banco_de_chile",
    "holder_id": "111111111"
  },
  "recipient_account": {
    "holder_id": "111111111",
    "institution_id": "cl_banco_de_chile",
    "number": "123456789",
    "type": "checking_account"
  }
}

Response

Result of the eligibility check. When the payment is not eligible, error describes the limit that the payment would exceed.

eligible_paymentboolean required

Whether the payment passes the transfer limits and can be created.

Example response

{
  "eligible_payment": true,
  "error": {
    "code": "maximum_amount_limit_error",
    "doc_url": "https://docs.fintoc.com/reference/errors",
    "param": "amount",
    "type": "amount_error"
  }
}