Skip to content

3D-Secure

Liquido supports 3DS payment verification for credit cards. Below are the currently supported countries.

Country Supported
Mexico
Brazil

3DS payment verification process

Direct payment flow

  1. Add the card3dsInfo object to the request body for credit card payment. Set the value of the use3ds field to true to enable 3DS payment verification. Set merchantSite3ds to the URL where you want users to be redirected after completing the verification process, allowing them to view the payment status.
  2. Upon receiving the request, Liquido will respond with a payment status of IN_PROGRESS, and you can find the threeDsRedirectUrl field under transferDetails.card.card3dsInfo.
  3. Redirect to the threeDsRedirectUrl to allow the payer to complete the 3DS authentication process. Once authentication is successful, the payment status will change to SETTLED.

Create A Payment With 3D-Secure

POST /v1/payments/charges/card

Request Headers
{
    "Content-Type": "application/json",
    "Authorization": "Bearer {{access_token}}",
    "x-api-key": "{{api_key}}"
}
Request Body
{
    "idempotencyKey": "1ec983fa-1a37-679b-809b-067861d87ab0",
    "paymentMethod": "CREDIT_CARD",
    "paymentFlow": "DIRECT",
    ...  # other basic request fields
    "card3dsInfo": {
        "use3ds": true,
        "merchantSite3ds": "https://www.liquido.com"
    },
    ...  # other basic request fields
}
Response
{
    "transferStatusCode": 200,
    "idempotencyKey": "1ec983fa-1a37-679b-809b-067861d87ab0",
    "paymentMethod": "CREDIT_CARD",
    "paymentFlow": "DIRECT",
    ...  # other basic response fields
    "transferDetails": {
        "card": {
            "cardInfo": {
                ... # card info fields
            },
            "card3dsInfo": {
                "use3ds": true,
                "merchantSite3ds": "https://www.liquido.com",
                "threeDsRedirectUrl": "https://3ds-redirect.liquido.com/15896579-b77e-4412-a3b3-aa1c5bcce0d6"
            }
        }
    },
    "transferStatus": "IN_PROGRESS",
    ...  # other basic response fields
}

Redirect payment flow

  1. Add the card3dsInfo object to the request body for credit card payment and set the value of the use3ds field to true.
  2. Upon receiving the request, Liquido will respond with a payment status of IN_PROGRESS, and you can find the redirectUrl field.
  3. Redirect the payer to the redirectUrl to complete the payment, including the 3DS authentication process. Upon successful completion, the payment status will change to SETTLED.

Create A Payment With 3D-Secure

POST /v1/payments/charges/card

Request Headers
{
    "Content-Type": "application/json",
    "Authorization": "Bearer {{access_token}}",
    "x-api-key": "{{api_key}}"
}
Request Body
{
    "idempotencyKey": "1ec983fa-1a37-679b-809b-067861d87ab0",
    "paymentMethod": "CREDIT_CARD",
    "paymentFlow": "REDIRECT",
    ...  # other basic request fields
    "card3dsInfo": {
        "use3ds": true
    },
    ...  # other basic request fields
}
Response
{
    "transferStatusCode": 200,
    "idempotencyKey": "1ec983fa-1a37-679b-809b-067861d87ab0",
    "paymentMethod": "CREDIT_CARD",
    "paymentFlow": "REDIRECT",
    ...  # other basic response fields
    "transferDetails": {
        "card": {
            "card3dsInfo": {
                "use3ds": true
            }
        }
    },
    "redirectUrl": "https://www.redirect-qa.liquido.com?uid=0f9d857f-920a-4429-a772-93add007f56c",
    "transferStatus": "IN_PROGRESS",
    ...  # other basic response fields
}
Back to top