Create Checkout Message Sequence - Card

Diagrams and steps for a 2-step card payment via a hosted page.

Some card payment methods allow authorization and capture as two separate operations. See Card Payment With Delayed Capture Message Sequences for more information.

Card payments with delayed capture expire if not captured within seven days of creation.

Success

This diagram shows the sequence of events when the card network authorizes the card and the transaction proceeds to successful completion.

The client sends Create Checkout Page request with capture set to false.
Rapyd sends a response containing a redirect URL to the client.
The client sends the URL to the customer.
The customer completes the checkout page and submits it directly to Rapyd.
Rapyd requests authorization from the card network.
The card network approves the card.
Rapyd sends Webhook - Payment Succeeded to the client. The status of the payment is set to ACT (active).
The client sends a Capture Payment request to Rapyd.
Rapyd asks the card network to capture the payment.
The card network captures the payment and transfers the funds to Rapyd.
Rapyd sends a response with details of the transaction to the client.
Rapyd sends Webhook - Payment Captured to the client.
Rapyd credits the wallet and sends Webhook - Payment Completed to client. The status of the payment is set to CLO (closed).

Failure

This diagram shows the sequence of events when the card network declines to authorize the transaction.

The client sends Create Checkout Page request with capture set to false.
Rapyd sends a response containing a redirect URL to the client.
The client sends the URL to the customer.
The customer completes the checkout page and submits it directly to Rapyd.
Rapyd creates a payment with status set to ACT (active). Rapyd requests authorization from the card network.
The card network declines the card.
Rapyd sends the Webhook - Payment Failed to client. The status of the payment is set to ERR (error).

In this section:

Documentation