Skip to main content

Payins Webhooks

Binco Payins provides webhooks to carry out and complete actions that may require more time and are performed asynchronously. For example, when a user completes all the data of their card, a webhook will take care of advancing with the process of registering a new payment instrument and notifying you.

To receive notifications from Binco's webhooks, you must configure a notification URL in your company's settings within the Binco platform. Then, when it's time to send a notification, Binco will send a POST to the URL you have configured.

Within the body of the POST, you will receive a JSON object with the necessary information for you to carry out the actions you deem necessary, as well as the type of notification you are receiving.

Currently, there are four types of webhooks available:

  • PAYMENT_INSTRUMENT_SUCCESS: New payment instrument added successfully.
  • PAYMENT_INTENT_PROCESSING: Payment intent is being processed.
  • PAYMENT_INTENT_SUCCESS: Payment intent completed successfully.
  • PAYMENT_INTENT_FAILED: Payment intent failed.

In the following subsections, you will find detailed information about each of these webhooks and the POST bodies you will receive in each case.