Authorization API
For merchants where full Avarda Checkout+ solution is not suitable or desired. Credit products Invoice, Loan and Part payment are supported for markets DK, FI, NO, SE .
Solution is based on rest APIs and partner handle the user dialog. Strong authentication/Electronic ID validation might be required for some scenarios – merchant then redirects user to the URL Avarda provides in the reponse where strong authentication can be peformed.
What needs to be prepared?
- Sign Agreement with Avarda. Contact sales@avarda.com if you want to know more or get help.
- Avarda creates user credentials for API:s and configure payment methods and options.
- Partner installs E-com module or integrates towards Avarda API.
- Test, Launch and Go live.
Avarda Authorization API credit process
Description
-
Authenticate via oAuth2 using your ClientID/ClientSecret recevied from Avarda.
-
Post authorization request to Avarda Authorization API Direct-Invoice, Invoice, Loan or Part-Payment.
-
Check HTTP response:
- 201 – Credit request approved by Avarda. Continue and fulfill order on partner side.
- 202- Credit request requires strong auth. Redirect to Electronic ID validation.
- 400 – Request has bad format or some of its data did not pass validation.
- 422 – Credit request was denied.
-
If HTTP Response 202 – Strong Auth is REQUIRED:
- Check response – if http response is 202 then electronic ID validation/strong auth is required. Response contains authoriationID and redirect url.
- redirect user to Avarda strong auth service defined in the redirect url.
- After electronicID validation/strong auth is successful then Avarda redirect user back to predefined partner URL with additional query parameter ?AuthorizationID=abcdefghijklmnopqrstuvz.
- Example: https://yourreturnurl.com/?authorizationId=d736dd5fea853b18a30fd2413ebfcab5 (opens in a new tab)
-
Merchant after redirect back from Avarda checks status on the credit request via api
/authorization/{id}
. If status approved then it is ok fulfill the order. -
On delivery – post request to Order and charge customer.
-
If return – post request to Return and credit customer.
-
If cancel – post request to Cancel to remove credit reservation