Manage beneficiaries

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

33603360

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
    }'

Did this page help you?