Trust SEPA beneficiaries

OAuth scope: beneficiary.trust

This operation requires Strong Customer Authentication and is only available for our Embed partners.

Trust up to 400 SEPA beneficiaries at once.

Trusting a beneficiary is important for API integrations because it enables automated transfers without requiring Strong Customer Authentication (SCA) verification for each transaction. When a beneficiary is not trusted, your users need to verify their identity for each transfer made via partner integrations.

Note for regular Qonto customers

If you are not using the API, you can also mark a beneficiary as trusted directly from the Qonto web app by enabling the “Allow automated transfers” option on the beneficiary’s profile. This option is available on web only. Learn how to mark a payee as trustworthy →

PATCH /v2/sepa/beneficiaries/trust

Trust SEPA beneficiaries

cURL

curl --request PATCH \
  --url https://thirdparty.qonto.com/v2/sepa/beneficiaries/trust \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'

200

Example

{
  "beneficiaries": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "iban": "<string>",
      "bic": "<string>",
      "status": "validated",
      "trusted": true,
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "email": "[e-mail]",
      "activity_tag": "<string>"
    }
  ]
}

Authorizations

Authorization · string · header · required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

X-Qonto-Staging-Token · string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Body

application/json

ids · string<uuid>[] · required

Array of beneficiary IDs to trust/untrust

Required array length: 1 - 400 elements

Response

200

application/json

Beneficiaries trusted successfully

beneficiaries · object[] · required

Show child attributes