Accept payments with Notch Pay’s hosted payment page
Notch Pay Collect is a hosted payment page that provides a simple and secure way to accept payments. With minimal integration effort, you can offer your customers a seamless payment experience with support for multiple payment methods.
Notch Pay Collect handles the entire payment process, including:
Implement payments with minimal code. No need to build your own payment form or handle payment processing logic.
Payment information is collected on Notch Pay’s secure servers, reducing your PCI compliance burden.
Support for various payment methods including Mobile Money and digital wallets like Assoh.
Works seamlessly on desktop and mobile devices with a responsive, user-friendly interface.
To use Notch Pay Collect, first create a payment using the API:
After creating a payment, you’ll receive an authorization_url
in the response. Redirect your customer to this URL to complete the payment:
When the payment is completed (or fails), Notch Pay will redirect the customer back to your callback
URL with the payment reference:
You should verify the payment status by calling the API:
Notch Pay Collect can be customized to match your brand and requirements:
When creating a payment, you can specify:
title
: Custom title for the collect pagedescription
: Detailed description of what the customer is paying forcallback
: URL to redirect after payment completionYou can restrict the available payment methods:
locked_channel
: Restrict to a specific payment channellocked_country
: Restrict to payment methods from a specific countrylocked_currency
: Restrict to a specific currencyFor more advanced customization, you can set up a custom collect page in your Notch Pay dashboard:
Then, when creating a payment, specify the template ID:
When processing payments through Collect, it’s important to understand the various transaction statuses:
Status | State | Description |
---|---|---|
pending | Transitional | Transaction has been initiated and awaits customer completion on the hosted page or direct api. |
processing | Transitional | Customer initiated the payment process, but it has not been completed yet. |
incomplete | Transitional | Customer pay less than payment amount. |
canceled | Final | Transaction has been cancelled. This status is final. |
failed | Final | Transaction has failed. This status is final. |
rejected | Final | Transaction has been rejected by our system or by operator. This status is final. |
abandoned | Final | Customer abandoned the payment on our hosted page. This status is final. |
expired | Final | Transaction has expired after 3 hours. This status is final. |
complete | Mixed | Transaction has been successfully completed. This status is final but can be refunded. |
refunded | Final | Transaction has been successfully refunded to customer. This status is final. |
partialy-refunded | Final | Transaction has been partialy refunded to customer. This status is final. |
The Notch Pay Collect flow consists of the following steps:
To test the collect flow:
If you encounter issues with Notch Pay Collect:
Accept payments with Notch Pay’s hosted payment page
Notch Pay Collect is a hosted payment page that provides a simple and secure way to accept payments. With minimal integration effort, you can offer your customers a seamless payment experience with support for multiple payment methods.
Notch Pay Collect handles the entire payment process, including:
Implement payments with minimal code. No need to build your own payment form or handle payment processing logic.
Payment information is collected on Notch Pay’s secure servers, reducing your PCI compliance burden.
Support for various payment methods including Mobile Money and digital wallets like Assoh.
Works seamlessly on desktop and mobile devices with a responsive, user-friendly interface.
To use Notch Pay Collect, first create a payment using the API:
After creating a payment, you’ll receive an authorization_url
in the response. Redirect your customer to this URL to complete the payment:
When the payment is completed (or fails), Notch Pay will redirect the customer back to your callback
URL with the payment reference:
You should verify the payment status by calling the API:
Notch Pay Collect can be customized to match your brand and requirements:
When creating a payment, you can specify:
title
: Custom title for the collect pagedescription
: Detailed description of what the customer is paying forcallback
: URL to redirect after payment completionYou can restrict the available payment methods:
locked_channel
: Restrict to a specific payment channellocked_country
: Restrict to payment methods from a specific countrylocked_currency
: Restrict to a specific currencyFor more advanced customization, you can set up a custom collect page in your Notch Pay dashboard:
Then, when creating a payment, specify the template ID:
When processing payments through Collect, it’s important to understand the various transaction statuses:
Status | State | Description |
---|---|---|
pending | Transitional | Transaction has been initiated and awaits customer completion on the hosted page or direct api. |
processing | Transitional | Customer initiated the payment process, but it has not been completed yet. |
incomplete | Transitional | Customer pay less than payment amount. |
canceled | Final | Transaction has been cancelled. This status is final. |
failed | Final | Transaction has failed. This status is final. |
rejected | Final | Transaction has been rejected by our system or by operator. This status is final. |
abandoned | Final | Customer abandoned the payment on our hosted page. This status is final. |
expired | Final | Transaction has expired after 3 hours. This status is final. |
complete | Mixed | Transaction has been successfully completed. This status is final but can be refunded. |
refunded | Final | Transaction has been successfully refunded to customer. This status is final. |
partialy-refunded | Final | Transaction has been partialy refunded to customer. This status is final. |
The Notch Pay Collect flow consists of the following steps:
To test the collect flow:
If you encounter issues with Notch Pay Collect: