Skip to main content

Documentation

Create Checkout Message Sequence - Card - 3DS

Diagrams and steps for when 3DS authentication is required for a card transaction via a hosted page.

Some card networks require 3DS authentication for certain transactions.

Success

This diagram shows the sequence of events when the card passes 3DS authentication, and the payment proceeds to successful completion.

  1. The client sends Create Checkout Page request to Rapyd.

  2. Rapyd sends the client a response containing a redirect URL.

  3. The client sends the URL to customer.

  4. The customer completes the checkout page and submits it directly to Rapyd.

  5. Rapyd sends Webhook - Payment Succeeded to the client. The status of the payment is set to ACT (active).

  6. Rapyd sends the URL of the 3DS authentication site to the customer.

  7. The customer completes the authentication requirements.

  8. The 3DS authentication site notifies Rapyd that the customer is authenticated.

  9. Rapyd requests a payment.

  10. The card network approves the payment and transfers the funds to Rapyd.

  11. Rapyd credits the wallet and sends Webhook - Payment Completed to the client. The status of the payment is set to CLO (closed).

Failure

This diagram shows the sequence of events when the card fails 3DS authentication.

  1. The client sends Create Checkout Page request to Rapyd.

  2. Rapyd sends a response containing a redirect URL to the client.

  3. The client sends the URL to the customer.

  4. The customer completes the checkout page and submits it directly to Rapyd.

  5. Rapyd sends Webhook - Payment Succeeded to the client. The status of the payment is set to ACT (active).

  6. Rapyd sends the URL of the 3DS authentication site to the customer.

  7. The customer completes the authentication requirements, but there is a serious error.

  8. The 3DS authentication site rejects the authentication.

  9. Rapyd sends Webhook - Payment Failed. The status of the payment is set to ERR (error).