When redirecting after an authorization, we will add several url parameters to the redirect so you know what happened during the authorization.
# Example successful redirect when no state was provided https://example.com/?referral=123
# Example successful redirect when state was provided https://example.com/?referral=123&state=mystatehere
# Example redirect with the customer declined https://example.com/?referral=123&state=mystatehere&error=access_denied&error_description=User%20declined%20authorization
Parameter | Description | Example |
---|---|---|
referral |
If an Authorization was created, you can look them up in
GET /authorizations?referrals=...
|
referral=1234 |
state |
The state ,
if any, that was specified in the authorization url.
|
state=abc123 |
error |
If something went wrong, one of:
|
error=access_denied |
error_description |
If something went wrong, a short description explaining what went wrong. | error_description=We%20are%20down%20%3A( |
referral
is used instead of OAuth's code
).
Since we don't need to issue access tokens for each individual Authorization,
we can just give you an identifier (referral
), and you can filter your
/authorizations
list with it.