Common request/response flows

The "conversation" between your store and the Bango Platform to identify a user might involve several Bango Payment API requests and responses, and the Bango Platform might ask your store to perform multiple actions. In practice, there are three main success scenarios:

• The Bango Platform returns a Bango ID in the first response
• The Bango Platform asks your store to send an SMS on behalf of the user, and the Bango ID will be available shortly after Bango has received and processed the SMS
• The Bango Platform asks your store to redirect the user to a web-based identification flow, and the Bango ID will be available shortly after the user has completed the flow

Some sequence diagrams might help you visualize these scenarios.

Bango ID available immediately

The Bango Platform identifies the user immediately, and returns the Bango ID in the response to the first API request.

Bango ID available after SMS received

The Bango Platform asks your store to send an SMS on behalf of the user. After you send the SMS (or ask the user to send the SMS, if you can't send an SMS without user interaction), the Bango Platform asks you to wait – one or more times – until it receives and processes the SMS.

Bango ID available after web-based identification flow completed

The Bango Platform asks your store to redirect the user to a web-based identification flow. After you redirect the user, the Bango Platform asks you to wait – one or more times – until the user completes the flow.