Manage beneficiaries

You have two options for the beneficiaries of your payments.
Please configure your choice on your dashboard.

1882 — Payment settings on your dashboard

Allow Payments to only one beneficiary

Complete the "Default beneficiary" on your dashboard with the fields :

Alias
Account name
IBAN
Bank Swift code
Bank name

All the payments initiated with your application will be send to this beneficiary.

Allow Payments to different beneficiaries

Activate the field "Allow payments to different beneficiaries".
For each payment you will need to send the details of the beneficiary in your payment request through the beneficiary resource.

name : name of the beneficiary
iban : IBAN of the beneficiary

curl 'https://sync.bankin.com/v2/payment-requests' \
    -X POST \
  -H 'Bankin-Version: 2019-02-18' \
    -H 'Client-Id: MY_CLIENT_ID' \
    -H 'Client-Secret: MY_CLIENT_SECRET'
  -H 'Content-Type: application/json' \
  -d '{
  "successful_callback_url": "https://my-callback-url.com:8080/pay/success",
  "unsuccessful_callback_url": "https://my-callback-url.com:8080/pay/error",
  "transactions": [
    {
      "external_merchant_id": "12345678-AFERS",
      "currency": "EUR",
      "label": "Payment label",
      "amount": 99.5,
      "beneficiary": {
    		"name": "Firstname Lastname",
    		"iban": "FR76XXXXXXXXXXXXXXXXXXXX185"
  		}
    }
  ],
  "user": {
    "name": "Firstname Lastname",
    "ip_address": "0.0.0.0",
    "external_reference": "AEF142536-890"
  },
  "bank_id": 6
}'