---
title: "Complete Payment"
source_url: https://docs.rapyd.net/en/complete-payment.html
lang: en
---

# 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.

[Checkout Demo](https://checkout.rapyd.net/demo)

> **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](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_payment_network_provider "Payment network provider") notifies Rapyd of the status of the transaction.

### Payment Outcome: Customer Update

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:

![6480833c47a59.png](image/img-d12774f8ca37fea0dfe22a285c0e2130.png)

### Failed Payment:

![6480833f320c8.png](image/img-61706414287fdf45482a043008a48fe5.png)

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](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_rds "Three-Domain Secure") 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’.

### Payment Outcome: Merchant Updates

### 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](https://docs.rapyd.net/en/payment-completed-webhook.md "Payment Completed Webhook").

**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](https://docs.rapyd.net/en/payment-failed-webhook.md "Payment Failed Webhook").

> **Note:**
>
> [Retrieve Checkout Page](https://docs.rapyd.net/en/retrieve-checkout-page.md "Retrieve Checkout Page") allows you to retrieve data about the checkout page, the payment and their statuses.