Manage beneficiaries

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

3360 — Payments settings on your dashboard

Payments to my bank account

Complete the beneficiary on your dashboard with the required fields below:

Beneficiary name
Bank name
IBAN
BIC

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

Allow Payments to different bank accounts

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://api.bridgeapi.io/v2/payment-requests' \
    -X POST \
    -H 'Bridge-Version: 2021-06-01' \
    -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": [
     {
       "end_to_end_id": "12345678-AFERS",
       "currency": "EUR",
       "label": "Payment label",
       "amount": 99.5,
       "client_reference": "12345678-AZERTY"
     }
    ],
    "user": {
       "name": "Firstname Lastname",
       "ip_address": "0.0.0.0",
       "external_reference": "AEF142536-890"
    },
    "beneficiary": {
       "name": "Firstname Lastname",
       "iban": "FR76XXXXXXXXXXXXXXXX"
    },
    "client_reference": "12345678-AZERTY",
    "bank_id": 6
    }'