Request Custom Approval

The BindID custom approval request initiates a custom approval flow for a specific need, such as updating account details or consenting to age restrictions. You can invoke a custom approval by calling the /authorize_ciba endpoint with a bindid_approval claim.

Here is an example of invoking the /authorize_ciba API with a bindid_approval claim, where the custom approval link is sent by SMS:

// Line breaks for readability

POST /authorize_ciba HTTP/1.1

Content-Type: application/x-www-form-urlencoded

Host: signin.bindid-sandbox.io

client_id=d0594078.f5c36acf.tid_4142b590.bindid.io

&client_secret=7d8dd34e-5866-4d11-b37c-d9b9c92c0bba

&scope=openid

&channel=%7B%22type%22%3A%22sms%22%2C%20%22target%22%3A%22%2B199999999999%22%7D

&claims=%7B%22id_token%22%3A%7B%22bindid_approval%22%3A%7B%22

essential%22%3Atrue%2C%22

value%22%3A%7B%22

display_data%22%3A%7B%22

main_attribute%22%3A%7B%22

label%22%3A%22

Account%20name%22%2C%22value%22%3A%22ACME%20

Suppliers%22%7D%2C%22attributes%22%3A%20%5B%7B%22label%22%3A%22

Bank%20name%22%2C%22value%22%3A%22Big%20Bank%22%2C%22

icon%22%3A%22Contract%22%7D%2C%7B%22label%22%3A%22

Account%20number%22%2C%22value%22%3A%22123456%22%2C%22

icon%22%3A%22Id%22%7D%5D%7D%7D%7D%7D%7D

The following image displays the location of the mainAttribute and attributes fields on the consent screen: