Shopify: take One Pay in your store
Let shoppers in your Shopify store pay with GCash, Maya or any QR Ph app. They check out as usual, choosing One Pay as the payment method. The order confirmation email has a Pay now button. When they pay, the order turns Paid in Shopify by itself and is tagged with the One Pay reference.
What you need
- A One Pay business account that's active.
- A Shopify store that sells in Philippine Peso (PHP). A store in another currency can't take One Pay.
Set it up (about 10 minutes)
- Add the payment method. In Shopify, go to Settings → Payments → Manual
payment methods → Create custom payment method and fill it in:
- Name:
One Pay. The connection matches this name exactly. - Additional details: "Pay with GCash, Maya, or any QR Ph app. You'll get a Pay now link right after you place your order."
- Payment instructions: "Check your order confirmation email and tap Pay now. Your order is processed once payment is received."
- Name:
- Connect the store to One Pay. One Pay staff connect your store. Today this uses a private app token from your store. A one-click install is coming.
- Add the Pay now button to the email. In Shopify, go to Settings → Notifications → Order confirmation → Edit code. Paste the block One Pay gives you just after the order summary heading, then save.
- Test it. Place an order with One Pay. Check that the email has the Pay now button, pay a small amount, and watch the order turn Paid within a minute.
What the shopper sees
- At checkout they choose One Pay and place the order.
- The confirmation email has Pay now with GCash, Maya or QR Ph.
- The button opens One Pay. It shows your store, the order number and the amount due, which One Pay reads from Shopify, not from the link.
- They pay. The order becomes Paid in Shopify, tagged
OnePay:<reference>.
A payment link stays open for 20 minutes. After that, tapping Pay now again starts a fresh one.
Good to know
- Only One Pay orders can be paid this way. The link refuses orders placed with another payment method, cancelled orders, orders already paid, and orders not in PHP.
- If you edit an order before it's paid, the link always asks for the current amount due. An older unpaid link for that order stops working.
- Refunds: refunding an order in Shopify does not refund the customer through One Pay. Contact One Pay to refund a One Pay payment.
- If a shopper pays an order you already marked paid or cancelled, One Pay doesn't change the order. It flags the payment for One Pay staff, who will contact you about a refund.
- If you uninstall the app or regenerate its token, One Pay pauses your pay links and order updates until staff reconnect the store.
- Fees: One Pay's usual fee applies to each payment, the same as any other.