API
  1. API Reference
API
  • Guides
    • Welcome
    • Interface
  • API Reference
    • Introduction
    • Endpoints
    • Data Types
    • Signing
    • 3-D Secure Verification
    • Subscription
    • Errors
    • Webhooks
    • Items Information
    • Changelog
    • Acquiring
      • Create a direct payment
        POST
      • Create a APM payment
        POST
      • Create a redirect (iFrame) payment
        POST
      • Query a transaction
        POST
      • Refund a transaction
        POST
      • Search a refund transaction
        POST
      • Review a transaction
        POST
      • Cancel a transaction
        POST
      • Cancel a subscription
        POST
      • Capture a transaction
        POST
      • Create a payout
        POST
      • Optimise payment methods
        POST
    • Issuing
      • Cardholder
        • Create cardholder
          POST
        • Delete cardholder
          POST
        • Query cardholder
          POST
      • Group
        • Create group
        • Query group details
        • Cancel group
        • Refund group
        • Update group status
        • Recharge group
      • Card
        • Create a card
        • Query card BIN
        • Recharge card
        • Withdraw from a card
        • Cancel a card
        • Update card status
        • Update card limit
        • Query card details
  • Appendix
    • Test Cards
    • Bank Code
    • Country Code
    • Currency Code
    • Payment Methods
  1. API Reference

3-D Secure Verification

3DS Response#

If a payment is sent for 3-D Secure Verification and the card is supported for the verification, merchant will then receive a response in XML format containing the ‘issuer_url’. Merchant needs to append ‘return_url’ and ‘notify_url’ to the ‘issuer_url’ as the 3-D Secure Verification target URL and send the request via POST method. The shopper will be redirected to the 3-D Secure Verification page hosted by the issuer. Once the shopper completed the verification, the verification result will be returned to the notify_url defined by merchant.
3DS Response

The response is in XML format. Merchant needs to parse the XML response before obtain the payment result.

Redirect user to 3DS challenge page#

To redirect shopper to the 3DS verification age, merchant needs to append "return_url" and "notify_url" to the "issuer_url" as the 3-D Secure Verification target URL and send the request via POST method.
3DS Redirect

Modified at 2025-05-27 11:41:25
Previous
Signing
Next
Subscription