toyyibPay Payment Gateway

Use this skill for toyyibPay payment gateway integration work.

Source

Read references/toyyibpay-docs.md before giving factual API guidance or writing integration code. It contains source URLs, environment bases, endpoint map, callback hash rules, amount units, DuitNow QR fields, dashboard setup notes, pricing/support notes, WooCommerce setup notes, and WorkDo configuration notes from the provided docs plus follow-up source checks.

Read references/account-setup.md when user asks how to register, which API keys are needed, where credentials come from, or what dashboard setup is required.

Core Workflow

1. Identify environment: sandbox at dev.toyyibpay.com or production at toyyibpay.com.
2. Confirm credential scope: User Secret Key, Category Code, and optional Enterprise User Secret Key.
3. Create or reuse a toyyibPay Category, then create local pending payment before creating a Bill.
4. Create Bill server-side with fixed amount in cents, internal reference in billExternalReferenceNo, return URL, and callback URL.
5. Redirect customer to https://toyyibpay.com/{BillCode} or sandbox equivalent.
6. Verify callback hash with MD5(userSecretKey + status + order_id + refno + "ok").
7. Re-check payment using getBillTransactions when possible, then settle idempotently after status, amount, channel, provider, and reference match.