Complete Payment
Finalize the customer payment experience.
Complete Payment takes you through the Hosted Checkout Customer Experience once they have completed a payment.
Preview the demo of the Hosted Checkout Customer Experience.
Note
Additional Steps for Completing a Payment After Checkout.
The following additional steps may be required to complete a payment after checkout, for many local and alternative payment methods:
visiting a cash location to make a cash payment, or
completing extra steps with the bank for a bank transfer.
If applicable, these special instructions are passed on to your customer on completion of a successful checkout session.
See example #1 below.
After the customer follows the Hosted Checkout instructions to complete the payment, the payment network provider notifies Rapyd of the status of the transaction.
Once the payment is completed, the customer receives confirmation of a successful or a failed payment, as seen in the examples below:
Successful Bank Transfer Requiring Completion:
Failed Payment:
Clicking the Finish or Cancel and go back buttons will take the customer back to your website: the fallback URL defined in the client portal or the complete_checkout_url, if they are provided in the Create Checkout Page request.
Payments Redirected to External Site for Payment Completion
Examples of such payment types are bank redirect, and card with 3DS authentication. When a payment of this type is completed successfully, the customer is redirected to the URL that you provided in complete_payment_url. When it fails, the customer is redirected to the URL you provided in error_payment_url.
A payment fails, for example, when you do not deposit cash before expiration of the allotted time. If these URLs are not provided, Rapyd redirects the customer back to the Checkout page.
For Checkout Toolkit integrations:
If the payment completes successfully, the customer is returned to your website, according to URL entered in ‘complete_payment_url’.
If the payment fails, the customer is returned to your website, according to the URL entered in ‘error_payment_url’.
Successful Payment:
If the payment is completed successfully, Rapyd sends a PAYMENT_COMPLETED webhook. The status of the payment is CLO ("closed") and the status of the webhook is also CLO. See Webhook - Payment Completed.
Note: If the payment method requires the action of a third party to complete the payment process, this webhook is triggered when the last required third-party action is completed.
Failed Payment:
If the payment fails, Rapyd sends a PAYMENT_FAILED webhook. The status of the payment is ERR ("error") and the status of the webhook is NEW, which indicates that the payment was not completed. See Webhook - Payment Failed.
Note
Retrieve Checkout Page allows you to retrieve data about the checkout page, the payment and their statuses.