method as wallet and the Alipay+ wallet code in wallet, and redirect your customer to approve the payment.
Early AccessAlipay+ on S2S is available on request. Contact your account manager or our Support team to have it enabled on your account before you start. Standard Checkout does not need this step.
Prerequisites
- Existing S2S integration: an active S2S JSON integration with Razorpay Curlec, including API keys.
- Alipay+ enabled for S2S: Alipay+ is not enabled by default. Tell us which wallets you want to offer and we will enable them. Before we switch it on, we register your business with Alipay+, so enablement is not instant. You need no agreement of your own with Alipay+ or with any individual wallet.
Wallet Codes
Pass one of these codes in thewallet field. Only the wallets enabled on your account are accepted.
Alipay+ is for overseas customers only. Your customer pays in their wallet’s currency, Alipay+ handles the currency conversion, and you create the order and are settled in Malaysian ringgit (
MYR).
Integration Steps
1.1 Check the Wallets Enabled on Your Account 1.2 Create an Order 1.3 Create a Payment 1.4 Redirect Your Customer 1.5 Confirm the Payment Status 1.6 Verify Payment Signature1.1 Check the Wallets Enabled on Your Account
Use the Methods API to check which Alipay+ wallets are enabled on your account, and show only those to your customer. The response lists every wallet enabled on your account, including Malaysian wallets such as Touch ‘n Go. The Alipay+ wallets are the codes listed in Wallet Codes, and the sample below shows only those.1.2 Create an Order
Create an order inMYR for every payment. The order_id in the response ties the payment to the order.
POST /orders
Request Parameters
amount mandatory
: integer The payment amount in the smallest currency subunit. For example, to charge RM 50.00, pass 5000.
currency mandatory
: string The currency of the order. Here, it must be MYR.
receipt optional
: string Your receipt ID for this order. Maximum length is 40 characters.
notes optional
: json object Key-value pairs to store additional information about the order. Maximum 15 pairs, 256 characters each.
Know more about the Orders API and the Orders entity.
1.3 Create a Payment
Create a payment against the order, withmethod as wallet and wallet as the Alipay+ wallet your customer chose.
POST /payments/create/json
Request Parameters
amount mandatory
: integer The payment amount in the smallest currency subunit. It must match the order amount.
currency mandatory
: string Here, it must be MYR.
order_id mandatory
: string The order ID returned in step 1.2.
email mandatory
: string Email address of the customer.
contact mandatory
: string Phone number of the customer, including the country code.
method mandatory
: string Here, it must be wallet.
wallet mandatory
: string The Alipay+ wallet to charge the customer through. Possible values: gcash, dana, truemoney, alipay, alipayhk, kakaopay and rabbitlinepay. See Wallet Codes.
callback_url mandatory
: string The URL your customer returns to after they complete or leave the payment.
Response Parameters
razorpay_payment_id
: string Unique identifier of the payment. Store it to check the payment status later.
next
: array The next step to continue the payment.
action
: string Here, it is redirect.
url
: string The URL to redirect your customer to so that they can approve the payment.
1.4 Redirect Your Customer
Redirect your customer to theurl in next. Alipay+ hosts the approval:
- On web, your customer sees the Alipay+ payment page and approves the payment in their wallet.
- On mobile, your customer may also be shown the payment page in a browser rather than being taken straight into the wallet app. The payment works either way.
1.5 Confirm the Payment Status
After approval, Razorpay Curlec confirms the result with Alipay+ before it authorises and captures the payment, so the final status can arrive shortly after your customer returns to yourcallback_url. Do not treat the redirect to your callback_url alone as confirmation. Confirm the status using one of these:
- Webhooks (recommended): subscribe to
payment.authorized,payment.captured,payment.failedandorder.paid. Know more about payment webhooks. - Fetch the payment: call the Fetch a Payment API with the
razorpay_payment_idand check thatstatusiscaptured.
created has not been approved yet. Do not ship the order until the payment is captured.
1.6 Verify Payment Signature
When your customer returns to yourcallback_url after a successful payment, the request contains razorpay_payment_id, razorpay_order_id and razorpay_signature. Verify the signature before you update the order in your system.
Create a string from the order_id you created in step 1.2 and the razorpay_payment_id, separated by |. Hash it using HMAC SHA256 with your API key secret, and compare it with razorpay_signature.
Refunds
You can refund Alipay+ payments in full or in part using the Refunds API.Frequently Asked Questions
Can I test Alipay+ on S2S before going live?
Can I test Alipay+ on S2S before going live?
A test mode flow is not available for Alipay+ today. Contact our Support team and we will confirm what is possible for your account.
Do I need to change my integration when a new wallet joins Alipay+?
Do I need to change my integration when a new wallet joins Alipay+?
Only to show the new wallet to your customers. Once we enable it on your account, it appears in the Methods API response, and you pass its code in the
wallet field like any other Alipay+ wallet.Can I take recurring payments with Alipay+?
Can I take recurring payments with Alipay+?
No. Alipay+ is for one-time payments only.