The bank name is typically used for payment routing. If the bank is not specified in the request, it will be automatically determined based on the card's BIN.However, BIN-based detection cannot guarantee 100% accuracy.
If your users are willing to specify the issuing bank of the card, it is recommended to include this field — doing so can improve payment success rates and enhance the reliability of financial flows.The bank name can be helpful in the following methods:Deposit H2H - Card & P2P — hosted on the secure
subdomain. Requires the merchant to have a PCI DSS certificate and allows direct card data transmission between servers (host-to-host). Deposit H2H - Token — hosted on the token
subdomain. Enables recurring payments using previously obtained tokens. Deposit H2С - Card — hosted on the init
subdomain. Does not require PCI DSS. Used to initiate a payment without card data; the user is then redirected to a web form to enter card details. How to use bankName example#
Bank name is used in the additionalFields
for deposit and payout. Here's an example of a query using bankName
:curl --request POST \
--url https:
--header 'Authorization: Bearer YOUR TOKEN' \
--header 'Content-Type: application/json' \
--header 'accept: text/plain' \
--data '{
"amount": 100
"currency": "USD"
"additionalFields": [
{
"key": "сardNumber"
"value": "1234123412341234"
},
{
"key": "bankName"
"value": "all"
}
]
}'
BankName dictionary#
Modified at 2025-05-29 07:20:29