Create a new beneficiary

Create a new beneficiary for a specific customer and client. Toqio will send a request to create a beneficiary with client Id and provider as param requests.

Beneficiary creation has two steps.

  • First, the beneficiary is created in Toqio side and this is managed by Toqio's system.
  • Second, the beneficiary must be created in the financial provider side. This step must be managed by your integration.

When a first payment for the beneficiary is setup your integration must check if the beneficiary exists in the financial provider side, if it does not, you must created it. If exists, you must proceed with the normal flow of the payment.

Usually, the integration uses a data base to store the beneficiary information. Then, when you need to check if the beneficiary exists in the provider system, you can query check your database avoiding one additional request to the bank which could have performance impact on the user flow

Language
Credentials
Bearer
JWT
Click Try It! to start a request and see the response here!