Payments
Record a Zoho customer payment when Shopify collects the money, and map each payment gateway to a Zoho account.
With Record payments on, Zync records a customer payment in Zoho against the order's invoice each time Shopify collects money. The invoice shows as paid, and the money lands in the Zoho account you choose.
Open Orders → Documents & Accounting → Payments.
Needs an invoice
Payments are recorded against an invoice. With Sales order as the document option there is none, and the page shows a warning. Pick an option that includes an invoice under Documents.
Switch it on
- Turn on Record payments.
- Set the Default payment method and the Default deposit account.
- Add gateway mappings if different gateways should go to different accounts.
- Save.
Defaults
| Setting | What it does |
|---|---|
| Default payment method | The Zoho payment mode for any gateway without a mapping: Cash, Cheque, Credit card, Bank transfer, Bank remittance, Auto transaction or Others |
| Default deposit account | The Zoho account the money is deposited to. (Zoho default) lets Zoho choose |
Gateway mapping
Send each Shopify gateway to its own payment method and deposit account. For example:
| Shopify gateway | Zoho payment method | Deposit account |
|---|---|---|
shopify_payments | Credit card | Shopify Payments Clearing |
Cash on Delivery (COD) | Cash | COD Receivable |
manual | Bank transfer | HDFC Current Account |
To add mappings:
- Click Find gateways in recent orders. Zync reads your last 100 orders and lists the gateways it finds, with a count. Click one to add it.
- Or type the exact Shopify gateway name and click Add gateway.
Then choose the payment method and deposit account for each row. Gateways with no row use the defaults.
What gets recorded
- One Zoho payment for each successful Shopify sale or capture. Authorisations that were never captured, and failed attempts, are ignored.
- The amount is the amount Shopify collected, in the currency you chose, and never more than the invoice still owes.
- The payment date is the date Shopify processed it.
- An order paid in parts (a deposit, then the balance) gets one Zoho payment per part.
If the invoice is still a draft, Zync marks it as sent first, because Zoho only accepts payments against an invoice that has left draft.
Cases to know
| Situation | What Zync does |
|---|---|
| The invoice has no balance left, for example it was settled by hand in Zoho | Records nothing for that transaction and does not look at it again |
| The order is paid after it synced | The payment is recorded when Shopify reports it. With Sales order, then invoice when paid, the invoice is raised first |
| The order was voided after cancellation | No payment is recorded |
| A sync is retried | Each payment carries a reference to its Shopify transaction. Zync looks that reference up in Zoho first, so a payment is never recorded twice |
Payments for past orders
Run a backfill with Only orders that are not in Zoho yet unticked. Orders already in Zoho are brought up to date, including any payment that is missing.