Universal 3-D Secure is also available without Gr4vy Embed as long as any payment service has been set up for 3-D Secure.
All you need to do to use 3-D Secure via the API is to set up 3-D
Secure on any of the enabled payment services and pass a
creating the transaction.
With 3-D Secure configured for a payment service, we will automatically detect
if it is required to get the buyer's approval for a transaction. If it is required
the API will return a transaction with the status
approval_url that the buyer can be sent to.
You can then redirect the buyer to the
approval_url and Gr4vy will handle all
the intricacies of 3-D Secure. Once the buyer has approved (or rejected) the
transaction the browser is redirected back to the
redirect_url that was set
when the transaction was created.
redirect_url will be appended with both a transaction ID and status.
We strongly recommend confirming the actual transaction status by fetching the
updated transaction by its
To optimize 3-D Secure it is highly recommended to provide a buyer with billing details attached to Gr4vy Embed.
A buyer can be set up via our
API. The buyer can then be attached to Gr4vy Embed by using the
buyerExternalIdentifier property. The buyer's name, email address, and billing
address will be used to help reduce buyers being requested to complete a 3-D
For every transaction Gr4vy will handle the following steps.
- Detect if the selected payment service for this transaction has 3-D Secure enabled
- Detect if the card used in the transaction is enrolled for 3-D Secure
- Handle the seemless frictionless 3-D Secure flow including the device finger
printing once the user is redirect to the
- Handle the 3-D Secure challenge flow, where a buyer is directed to their bank to approve the transaction.