Quickstart Guide
Get up and running with Notch Pay in minutes
This guide will help you integrate Notch Pay into your application or website quickly. We’ll walk through the basic steps to accept your first payment.
Prerequisites
Before you begin, make sure you have:
Integration Steps
Get Your API Keys
- Log in to your Notch Pay Business suite
- Navigate to Settings > API Keys
- Copy your API key (use your test key for development and testing)
- Log in to your Notch Pay Business suite
- Navigate to Settings > API Keys
- Copy your API key (use your test key for development and testing)
Test keys contains test_
while live keys doesn’t.
Create a Simple Payment
Let’s create a basic payment using the Notch Pay API:
Redirect to the Payment Page
After creating a payment, you’ll receive a response with an authorization_url
. Redirect your customer to this URL to complete the payment:
Handle the Callback
When the payment is completed (or fails), Notch Pay will redirect the customer back to your callback
URL with the payment status:
Set Up Webhooks (Recommended)
For more reliable payment notifications, set up webhooks to receive real-time updates about payment status changes:
Create Webhook Endpoint
Create an endpoint on your server to receive webhook events:
Register Webhook URL
- Go to your Dashboard > Settings > Webhooks
- Add a new webhook with your endpoint URL (e.g.,
https://your-website.com/webhooks
) - Select the events you want to receive (e.g.,
payment.complete
,payment.failed
)
Secure Your Webhooks
Check our Webhook Security Guide for implementation details.
Next Steps
Here are some next steps to enhance your integration:
Explore Payment Methods
Offer more payment options to your customers
Customer Management
Save customer information for future payments
Webhook Setup
Set up reliable payment notifications
Testing
Test your integration thoroughly before going live
Sample Applications
Check out these sample applications to see Notch Pay in action:
JavaScript/Node.js
Example Node.js integration
PHP
Example PHP integration
Python
Example Python integration