Payment Links
Collect payments outside your checkout with a secure, Payrails-hosted payment page.
What Payment Links are
A Payment Link is a shareable URL that opens a Payrails-hosted payment page. You create the link from your backend or from the Payrails Portal, share it with your customer through any channel, and Payrails handles the payment page, the processing, and PCI compliance.
No frontend integration is required, and your customer does not need an account or an app. The link opens in any browser.
In the Payrails API reference, this resource is called a drop-in link, and the endpoints live under
/merchant/dropInLinks.
Example of a Payrails-hosted payment page using Payrails branding. Your hosted page will use your own brand logo, colors and fonts.
When to use Payment Links
Use Payment Links when payment happens outside your main checkout flow:
- An agent or support team member collects payment during a call or a chat
- You request payment after an order, a booking, or a service interaction
- You collect a deposit, an installment, or the balance of an invoice
- Several people need to contribute towards one total
- You want to start accepting payments without building a checkout integration first
Use Payrails SDK solutions instead when payment is embedded directly in your product's purchase flow.
Payment Links compared with Payrails SDK solutions
| Payment Links | Payrails SDKs | |
|---|---|---|
| Where payment happens | Payrails-hosted page, opened from a link | Embedded in your own checkout flow |
| Integration effort | One API call, or no code via the Portal | SDK integration |
| Who initiates | You or your agent, asynchronously | The customer, in session |
| Frontend work | None | Required |
| Partial payments | Supported | Not applicable |
| Best for | Assisted, operational, and follow-up payments | Your primary purchase flow |
What you get
| Payment page | Hosted by Payrails |
|---|---|
| Creation | API or Portal |
| Payment modes | Single payment, or partial payments against a total |
| Payment methods | All payment methods you have enabled in your workflow |
| Branding | Configured by Payrails during onboarding |
| Language | English |
| Domain | Payrails-managed |
| Notifications | Webhooks |
| Expiry | Required on every link |
| Editing a link | Not supported. As a workaround, you can delete a link and create a new one |
Before you start
Payment Links is enabled and configured per merchant account rather than self-serve. Agree on the following with your Payrails contact before going live.
| Setting | What to provide | Why it matters |
|---|---|---|
| Brand assets | Logo, brand colors, font | Applied to your hosted payment page |
| Required payer fields | Which fields the payer must complete | Controls what the hosted page collects |
| Capture behavior | Immediate or delayed capture | Set through your workflow configuration |
What to prepare on your side
- API credentials for the test environment
- The workflow code used for payment acceptance
- An HTTPS webhook endpoint that accepts POST requests and acknowledges quickly
- A merchant reference scheme you can reconcile against, such as an invoice or order number
Test and live environments
Test and live environments are isolated:
- Webhooks are configured separately for each environment
- A link created in test cannot be used in production
- Validate the full lifecycle in test, including a webhook you have actually received and processed, before enabling live
Repeat your configuration in the live environment before launch. Environment mismatch is one of the most common causes of a failed go-live.
Next steps
- How it works — the lifecycle, link statuses, and who is responsible for what
- Create a payment link — your first link in test
Updated 35 minutes ago