Supported workflows
| Workflow | Supported |
|---|---|
| Payrails SDK | ✔ |
| Payrails API | ✔ |
| Delayed / Manual Capture | ✖ |
| Instant Capture | ✔ |
| Cancel / Void | ✖ |
| Refund / Reverse | ✖ |
| Save Instruments | ✖ |
| Merchant Initiated Transaction (MIT) | ✖ |
Before you begin
Complete these steps before you send your first Razer Gold payment through Razer:- Set up a Razer integration in your workspace. Follow the Razer integration setup guide if you don’t have one yet.
- Ask Razer to enable the Razer Gold wallet channel on your application.
- In the Payrails Portal, go to Settings → Integrations, open your Razer integration, select Razer Gold under Payment methods, and save.
- Add Razer Gold as a payment option in your workflow.
Request fields for Razer
Send these fields in the authorize request, in addition to the standard authorize fields. Required fields must be present for the payment to succeed. Payrails sends Optional fields to the PSP when you include them.Field mapping
Payrails builds each Razer payment request from your authorize request and the Razer integration. This table shows where every Razer parameter comes from.Authorize a Razer Gold payment
Call authorize a payment withrazerGold as the paymentMethodCode. The response includes the redirect to the Razer Gold checkout page.
Authorize request
holderReference when you create the workflow execution. The payment stays pending until the customer approves it. Confirm the result through webhook notifications or the execution status before you fulfill the order.
How Razer handles Razer Gold
- Payrails creates the payment at Razer and returns a redirect to the Razer checkout page. Razer doesn’t allow its checkout page in a frame, so the redirect opens in a full page.
- When the customer returns, Payrails queries Razer for the payment status. Razer also sends a signed result to Payrails, which updates the payment.
- Payrails checks the signature on every response and result from Razer before it updates the payment.
- Razer settles payments immediately, so a successful payment shows as Captured. The Razer payment ID, which starts with
MPO, shows as the integration reference. - An unpaid payment stays pending. If the customer doesn’t complete the payment, it expires at Razer and Payrails marks it as failed.
- Each Razer Gold payment is a one-time, customer-initiated payment. Use a new payment for each attempt: Razer rejects a payment that reuses an earlier payment’s reference.