There are different ways to use your Fintoc Account Number(CLABE in Mexico). You can assign a Account Number to a specific user's payments or create a single-use Account Number for specific payment orders. This guide shows how to update your Account Number to make payin handling easier.

Disable a Account Number

If you disable a Account Number, all payins directed to it will be automatically rejected and returned to the sender. If a Account Number is no longer intended to receive payments, disabling it prevents you from handling stray inbound payments.

Example use cases

• Your company assigns one Account Number per user and Jared has completed offboarding from your app. Disable Jared's Account Number so payments made for Jared's user are automatically returned and don't waste your operational resources.
• Your company assigns one Account Number per order and Richard bought a computer at your store. Disable Richard's computer order Account Number once he has paid to avoid receiving a double payment. If Richard misses the payment confirmation notice and pays twice, the money will be returned automatically and won't waste your operational resources.

Disabling a Account Number with our API

account_number = client.v2.account_numbers.update(
  "acno_Kasf91034gj1AD",
  status="disabled"
)

const accountNumber = await fintoc.v2.accountNumbers.update(
	"acno_Kasf91034gj1AD",
  status: 'disabled'
);

curl --request PATCH \
     --url https://api.fintoc.com/v2/account_numbers/acno_jKaHD105H \
     --header 'Authorization: sk_test_jKaHdEa3mfmP0D105H' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "status": "disabled"
}
'

Set inbound transfer amount limits

You can set boundaries to restrict which inbound transfers your Account Number accepts. If a transfer does not meet these criteria, Fintoc rejects it. Rejected transfers do not appear on your account statements and do not incur fees.

Setting limits via API

account_number = client.v2.account_numbers.create(
  options={
    min_amount=300,
    max_amount=400
  }
)

const accountNumber = await fintoc.v2.accountNumbers.create(
  options: {
  	max_amount: 300,
  	min_amount: 400
  }
);

curl --request POST \
     --url https://api.fintoc.com/v2/account_numbers \
     --header 'Authorization: sk_test_jKaHdEa3mfmP0D105H' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
     {
     "options": {
     	max_amount: 400,
     	min_amount: 300
     }
   }
'