# Bayarcash Help > Help articles for Bayarcash (bayarcash.com), a Malaysian payment gateway for FPX, DuitNow, cards, e-wallets and Direct Debit. Key facts: - Bayarcash console: https://console.bayar.cash - merchants sign in there. Sandbox: https://console.bayarcash-sandbox.com. - API reference: https://api-reference.bayarcash.com. Service status: https://status.bayarcash.com. - Bayarcash is a product of Bayarcash Sdn. Bhd. 202201040365 (1486062-H), Malaysia. - Malay translations, where they exist, are at /ms//. - Simplified Chinese (Malaysia) translations, where they exist, are at /zh//. - Official channels: support email support@bayarcash.com, WhatsApp support https://whatsapp.bayarcash.com, Telegram (latest updates) https://telegram.bayarcash.com, Facebook https://facebook.com/mybayarcash, GitHub (plugins and integrations) https://github.com/bayarcash, YouTube https://www.youtube.com/@BayarcashMY. --- # What is Bayarcash, and how is it different from BCL? > Bayarcash is the payment gateway that collects your money. BCL is a separate selling platform that uses Bayarcash behind it. > > Source: https://docs.bayarcash.com/what-is-bayarcash/ Bayarcash is a payment gateway. It collects payments from your customers and pays the money out to your bank account. BCL (formerly Bayarcash Link) is a separate product from the same company, where you build payment pages and forms. BCL uses Bayarcash to collect its payments. ## What each one does Pick the one that matches what you want to do: | | Bayarcash | BCL | |---|---|---| | What it is | A payment gateway | A platform for selling online | | Use it to | Accept payments on your own website or shop, through a plugin or the API | Build payment forms, payment links and landing pages without a website | | Where you sign in | [console.bayar.cash](https://console.bayar.cash/login) | bcl.my | | Payment methods | Set on your Bayarcash account | Uses the payment methods on your Bayarcash account | | Help | This help centre | [docs.bcl.my](https://docs.bcl.my) | ## What you can do with Bayarcash Bayarcash gives you these tools. ### Take payments - [Payment methods](https://docs.bayarcash.com/payment-channels/): FPX, DuitNow, cards, e-wallets and buy now pay later. - [Customers from abroad](https://docs.bayarcash.com/cross-border-channels/): QRIS, NETS, PromptPay, Alipay and WeChat Pay. - [Direct Debit](https://docs.bayarcash.com/e-mandates/): Weekly or monthly payments after an e‑Mandate. ### Manage your money - [Portals](https://docs.bayarcash.com/portals/): Keep each shop, form or project separate. - [Payouts](https://docs.bayarcash.com/payout-schedule/): When the money reaches your bank account. - [Payout calculator](https://docs.bayarcash.com/payout-calculator/): What you receive after the Bayarcash fees. - [Merchant dashboard](https://docs.bayarcash.com/transactions/): Transactions, reports and Excel exports. ### Connect your shop or app - [Plugins](https://docs.bayarcash.com/woocommerce/): WooCommerce, GiveWP, Fluent Forms, WHMCS and more. - [e-Invoices](https://docs.bayarcash.com/myinvois-e-invoice/): LHDN MyInvois e-invoices from WooCommerce. - [Developers](https://docs.bayarcash.com/developers/): The API v3, the sandbox, SDKs and n8n. ## How they work together If you use BCL, you connect it to your Bayarcash account with your API keys. Your customer pays on a BCL page, and Bayarcash handles the payment. See [Find your API keys](/api-keys/) for where the keys are. New to Bayarcash? Start with [Sign up for Bayarcash](/sign-up/). ## Common issues ### Do I need both Bayarcash and BCL? No. You can use Bayarcash on its own, with your own website or shop plugin. BCL is for merchants who want a ready-made place to sell, and it needs a Bayarcash account to take real payments. ### Where do I sign in to each one? Bayarcash is at console.bayar.cash. BCL is at bcl.my. They are separate logins. ### Who do I ask when I have a question? Ask Bayarcash about payments, payouts, your portals and your API keys. Ask BCL about the forms, payment links and pages you build at bcl.my. BCL has its own help centre at docs.bcl.my. --- # Apa itu Bayarcash & apa bezanya dengan BCL? > Bayarcash ialah payment gateway yang mengutip bayaran anda, manakala BCL ialah platform jualan berasingan yang menggunakan Bayarcash. > > Source: https://docs.bayarcash.com/ms/what-is-bayarcash/ Bayarcash ialah payment gateway. Bayarcash mengutip bayaran daripada pelanggan anda dan membuat payout ke akaun bank anda. BCL (dahulu Bayarcash Link) ialah produk lain daripada syarikat yang sama. Dengan BCL, anda membina page bayaran dan form. BCL menggunakan Bayarcash untuk mengutip bayarannya. ## Fungsi setiap satu Pilih yang sesuai dengan keperluan anda: | | Bayarcash | BCL | |---|---|---| | Apa itu | Payment gateway | Platform untuk menjual secara online | | Guna untuk | Terima bayaran di laman web atau kedai online anda sendiri, melalui plugin atau API | Bina payment form, payment link dan landing page tanpa laman web | | Tempat log masuk | [console.bayar.cash](https://console.bayar.cash/login) | bcl.my | | Kaedah bayaran | Ditetapkan pada akaun Bayarcash anda | Menggunakan kaedah bayaran pada akaun Bayarcash anda | | Bantuan | Help Centre ini | [docs.bcl.my](https://docs.bcl.my) | ## Apa yang anda boleh buat dengan Bayarcash Bayarcash menyediakan fungsi berikut. ### Terima bayaran - [Kaedah bayaran](https://docs.bayarcash.com/ms/payment-channels/): FPX, DuitNow, kad, e-wallet dan buy now pay later. - [Pelanggan dari luar negara](https://docs.bayarcash.com/ms/cross-border-channels/): QRIS, NETS, PromptPay, Alipay dan WeChat Pay. - [Direct Debit](https://docs.bayarcash.com/ms/e-mandates/): Potongan mingguan atau bulanan melalui e‑Mandate. ### Uruskan wang anda - [Portal](https://docs.bayarcash.com/ms/portals/): Asingkan bayaran setiap kedai, form atau projek. - [Payout](https://docs.bayarcash.com/ms/payout-schedule/): Bila wang masuk ke akaun bank anda. - [Kalkulator payout](https://docs.bayarcash.com/ms/payout-calculator/): Jumlah yang anda terima selepas caj Bayarcash. - [Merchant dashboard](https://docs.bayarcash.com/ms/transactions/): Transaksi, laporan dan export Excel. ### Sambungkan kedai atau aplikasi anda - [Plugin](https://docs.bayarcash.com/ms/woocommerce/): WooCommerce, GiveWP, Fluent Forms, WHMCS dan lain-lain. - [e-Invois](https://docs.bayarcash.com/ms/myinvois-e-invoice/): e-Invois LHDN MyInvois dari WooCommerce. - [Developer](https://docs.bayarcash.com/ms/developers/): API v3, sandbox, SDK dan n8n. ## Cara Bayarcash & BCL berfungsi bersama Jika anda guna BCL, sambungkan BCL kepada akaun Bayarcash anda dengan API keys anda. Pelanggan anda membayar di page BCL, dan Bayarcash memproses bayaran itu. Untuk lokasi keys itu, lihat [Cari API keys dan portal key anda](/ms/api-keys/). Baru guna Bayarcash? Mulakan dengan [Daftar akaun Bayarcash](/ms/sign-up/). ## Isu biasa ### Adakah saya perlu guna kedua-dua Bayarcash dan BCL? Tidak. Anda boleh guna Bayarcash sahaja, dengan laman web anda sendiri atau plugin kedai online anda. BCL sesuai untuk merchant yang mahu tempat jualan yang sudah siap. BCL memerlukan akaun Bayarcash untuk menerima bayaran sebenar. ### Di mana saya log masuk untuk setiap satu? Bayarcash di console.bayar.cash. BCL di bcl.my. Anda perlu log masuk secara berasingan untuk setiap satu. ### Siapa yang saya perlu hubungi jika saya ada soalan? Tanya Bayarcash tentang bayaran, payout, portal dan API keys anda. Tanya BCL tentang form, payment link dan page yang anda bina di bcl.my. BCL ada Help Centre sendiri di docs.bcl.my. --- # Bayarcash是什么?它和BCL有什么不同? > Bayarcash是帮你收款的支付网关。BCL是另一个销售平台,背后使用Bayarcash收款。 > > Source: https://docs.bayarcash.com/zh/what-is-bayarcash/ Bayarcash是一个支付网关。它向你的顾客收款,再把钱转入你的银行账户(payout)。BCL(前称Bayarcash Link)是同一家公司的另一个产品,你可以用它创建付款页面和表单。BCL使用Bayarcash来收款。 ## 两者各做什么 选择符合你需要的一个: | | Bayarcash | BCL | |---|---|---| | 它是什么 | 支付网关 | 网上销售平台 | | 用途 | 通过插件或API,在你自己的网站或网店接受付款 | 不需要网站,就能创建付款表单、付款链接和landing page | | 登录地点 | [console.bayar.cash](https://console.bayar.cash/login) | bcl.my | | 付款方式 | 在你的Bayarcash账号设置 | 使用你Bayarcash账号上的付款方式 | | 帮助 | 本Help Centre | [docs.bcl.my](https://docs.bcl.my) | ## Bayarcash能帮你做什么 Bayarcash为你提供以下工具。 ### 收款 - [付款方式](https://docs.bayarcash.com/zh/payment-channels/): FPX、DuitNow、卡、电子钱包和先买后付。 - [海外顾客](https://docs.bayarcash.com/zh/cross-border-channels/): QRIS、NETS、PromptPay、Alipay和WeChat Pay。 - [Direct Debit](https://docs.bayarcash.com/zh/e-mandates/): 完成e‑Mandate后,每周或每月扣款。 ### 管理你的钱 - [Portal](https://docs.bayarcash.com/zh/portals/): 把每个网店、表单或项目分开。 - [Payout](https://docs.bayarcash.com/zh/payout-schedule/): 钱什么时候转入你的银行账户。 - [Payout计算器](https://docs.bayarcash.com/zh/payout-calculator/): 扣除Bayarcash手续费后,你会收到多少。 - [商家后台](https://docs.bayarcash.com/zh/transactions/): 交易、报告和Excel导出。 ### 连接你的网店或App - [插件](https://docs.bayarcash.com/zh/woocommerce/): WooCommerce、GiveWP、Fluent Forms、WHMCS等。 - [电子发票](https://docs.bayarcash.com/zh/myinvois-e-invoice/): 从WooCommerce开出LHDN MyInvois电子发票。 - [开发者](https://docs.bayarcash.com/zh/developers/): API v3、sandbox、SDK和n8n。 ## 两者如何一起运作 如果你使用BCL,就要用你的API key把BCL连接到你的Bayarcash账号。顾客在BCL页面付款,由Bayarcash处理这笔付款。key在哪里,请看[找到你的Bayarcash API key、PAT和portal key](/zh/api-keys/)。 第一次使用Bayarcash?请从[注册Bayarcash](/zh/sign-up/)开始。 ## 常见问题 ### 我需要同时使用Bayarcash和BCL吗? 不需要。你可以只用Bayarcash,搭配你自己的网站或网店插件。BCL适合想要一个现成销售平台的商家,而BCL需要Bayarcash账号才能收取真实付款。 ### 这两个平台分别在哪里登录? Bayarcash在console.bayar.cash,BCL在bcl.my。两者要分开登录。 ### 有问题时应该问谁? 付款、payout、portal和API key的问题,请问Bayarcash。你在bcl.my创建的表单、付款链接和页面的问题,请问BCL。BCL有自己的Help Centre:docs.bcl.my。 --- # Sign up for Bayarcash > Register a Bayarcash merchant account on the Bayarcash registration page, and check which businesses Bayarcash accepts before you start. > > Source: https://docs.bayarcash.com/sign-up/ You register for Bayarcash on the Bayarcash registration page. Once Bayarcash approves your account, you sign in to the merchant dashboard, set up a portal and get your API keys. ## Who can register Bayarcash serves registered businesses and organisations. The Bayarcash plugin information names these kinds of merchant: - A business with an active SSM certificate. - A non-governmental organisation (NGO) registered with the Registrar of Societies (ROS). - A madrasah or sekolah tahfiz with state certification. - A yayasan (foundation). Bayarcash is Shariah-compliant, so some types of business cannot use it. If you are not sure yours qualifies, ask the Bayarcash team before you apply. ## Register You need an email address you can open, because you use it to sign in later. To register: 1. Open the [Bayarcash registration page](https://onboard.bayarcash.com). 2. Follow the steps on the page and give the details and documents it asks for. 3. Submit your application and wait for Bayarcash to review it. Have your business registration documents ready before you start. ## After you are approved Once your account is approved, you can start setting up: 1. [Sign in](/sign-in/) to the merchant dashboard. 2. Set up a [portal](/portals/) for your payments. 3. Get your [API keys](/api-keys/) to connect your website or shop. ## Common issues ### How long does approval take? This guide does not give a time, because none is published. Ask the Bayarcash team through the Need more help? box at the bottom of the page. ### Can I try Bayarcash before my account is approved? Developers can. Bayarcash has a separate sandbox merchant dashboard at console.bayarcash-sandbox.com for testing. Sandbox keys do not work on the live merchant dashboard. --- # Daftar akaun Bayarcash > Daftar akaun merchant di page pendaftaran Bayarcash, dan semak jenis perniagaan yang Bayarcash terima sebelum anda mula. > > Source: https://docs.bayarcash.com/ms/sign-up/ Anda mendaftar akaun Bayarcash di page pendaftaran Bayarcash. Selepas Bayarcash meluluskan akaun anda, log masuk ke merchant dashboard, tambah portal dan dapatkan API keys anda. ## Siapa yang boleh mendaftar Bayarcash menerima perniagaan dan organisasi yang berdaftar. Maklumat plugin Bayarcash menyenaraikan jenis merchant ini: - Perniagaan dengan sijil SSM yang aktif. - Pertubuhan bukan kerajaan (NGO) yang berdaftar dengan Jabatan Pendaftaran Pertubuhan (ROS). - Madrasah atau sekolah tahfiz yang ada pengiktirafan negeri. - Yayasan. Bayarcash patuh Syariah, jadi sesetengah jenis perniagaan tidak boleh menggunakannya. Jika anda tidak pasti perniagaan anda layak, tanya team Bayarcash sebelum anda memohon. ## Daftar Anda memerlukan alamat e-mel yang anda boleh buka, kerana anda akan log masuk dengan e-mel itu nanti. Untuk mendaftar: 1. Buka [page pendaftaran Bayarcash](https://onboard.bayarcash.com). 2. Ikut langkah pada page itu, dan berikan butiran serta dokumen yang diminta. 3. Hantar permohonan anda dan tunggu Bayarcash menyemaknya. Sediakan dokumen pendaftaran perniagaan anda sebelum anda mula. ## Selepas akaun anda diluluskan Selepas akaun anda diluluskan, anda boleh mula menyediakan akaun itu: 1. [Log masuk](/ms/sign-in/) ke merchant dashboard. 2. Tambah [portal](/ms/portals/) untuk bayaran anda. 3. Dapatkan [API keys](/ms/api-keys/) anda untuk menyambungkan laman web atau kedai online anda. ## Isu biasa ### Berapa lama masa untuk akaun saya diluluskan? Panduan ini tidak menyatakan tempoh, kerana Bayarcash tidak menerbitkan tempoh kelulusan. Tanya team Bayarcash melalui kotak Need more help? di bahagian bawah page. ### Boleh saya cuba Bayarcash sebelum akaun saya diluluskan? Developer boleh. Bayarcash ada merchant dashboard sandbox yang berasingan di console.bayarcash-sandbox.com untuk ujian. Keys sandbox tidak berfungsi pada merchant dashboard live. --- # 注册Bayarcash > 在Bayarcash注册页面注册商家账号。开始前,先看看Bayarcash接受哪些商家。 > > Source: https://docs.bayarcash.com/zh/sign-up/ 你在Bayarcash注册页面注册。Bayarcash批准你的账号后,你就可以登录商家后台(merchant dashboard),设置portal并取得API key。 ## 谁可以注册 Bayarcash服务已注册的企业和机构。Bayarcash插件资料列出了以下几类商家: - 持有有效SSM证书的企业。 - 在社团注册局(ROS)注册的非政府组织(NGO)。 - 获得州政府认证的madrasah或sekolah tahfiz。 - 基金会(yayasan)。 Bayarcash符合伊斯兰教法(Shariah),所以某些类型的生意不能使用。如果你不确定自己是否符合资格,请在申请前询问Bayarcash团队。 ## 注册 你需要一个能打开的电邮地址,因为之后要用它登录。注册步骤: 1. 打开[Bayarcash注册页面](https://onboard.bayarcash.com)。 2. 按照页面上的步骤,提供它要求的资料和文件。 3. 提交申请,等待Bayarcash审核。 开始前,先准备好你的商业注册文件。 ## 获得批准后 账号批准后,你就可以开始设置: 1. [登录](/zh/sign-in/)商家后台。 2. 为你的付款设置一个[portal](/zh/portals/)。 3. 取得[API key](/zh/api-keys/),连接你的网站或网店。 ## 常见问题 ### 审批需要多久? 本指南没有写出时间,因为官方没有公布审批时间。请通过页面底部的Need more help?框询问Bayarcash团队。 ### 账号批准前,我可以先试用Bayarcash吗? 开发者可以。Bayarcash有另一个sandbox商家后台console.bayarcash-sandbox.com,专门用来测试。sandbox的key不能在正式商家后台使用。 --- # Bayarcash login: sign in to the merchant dashboard > Bayarcash login: sign in (log in) to the merchant dashboard with your registered email and password, and what to do when you cannot sign in. > > Source: https://docs.bayarcash.com/sign-in/ Sign in to the merchant dashboard to see your transactions, payouts, portals and API keys. Use the email address you registered with Bayarcash. ## Sign in You need your registered email and your password. To sign in: 1. Go to [console.bayar.cash/login](https://console.bayar.cash/login). 2. Enter your email and password. 3. Choose **Login to Console**. Your dashboard opens. *(Screenshot: The Login page with the Login to Console button highlighted)* ## First time signing in If it is your first time, set your own password first, then sign in. See [Reset or change your password](/reset-password/) and follow the steps for a forgotten password. > **Note** > The email address must be the one registered with Bayarcash. Any other address will not work. ## Testing in the sandbox Developers can test without real money on the sandbox merchant dashboard at [console.bayarcash-sandbox.com](https://console.bayarcash-sandbox.com). It has its own API keys. See [Find your API keys](/api-keys/). ## Common issues ### I cannot sign in. What should I do? Check that you are using the email you registered with Bayarcash, then reset your password. See Reset or change your password (/reset-password/). ### Is this the same login as BCL? No. The merchant dashboard at console.bayar.cash and BCL at bcl.my have separate logins. See What is Bayarcash (/what-is-bayarcash/). --- # Bayarcash login: log masuk ke merchant dashboard > Bayarcash login: log masuk ke merchant dashboard dengan e-mel dan password yang anda daftarkan, dan apa yang perlu dibuat jika tidak dapat log masuk. > > Source: https://docs.bayarcash.com/ms/sign-in/ Log masuk ke merchant dashboard untuk melihat transaksi, payout, portal dan API keys anda. Guna alamat e-mel yang anda daftarkan dengan Bayarcash. ## Log masuk Anda memerlukan e-mel berdaftar dan password anda. Untuk log masuk: 1. Pergi ke [console.bayar.cash/login](https://console.bayar.cash/login). 2. Masukkan e-mel dan password anda. 3. Klik **Login to Console**. Dashboard anda dibuka. *(Screenshot: Page Login dengan butang Login to Console ditanda)* ## Log masuk kali pertama Jika ini kali pertama anda log masuk, tetapkan password anda sendiri dahulu, kemudian log masuk. Lihat [Reset atau tukar password Bayarcash anda](/ms/reset-password/) dan ikut langkah untuk password yang terlupa. > **Note** > Anda mesti guna alamat e-mel yang berdaftar dengan Bayarcash. Alamat lain tidak akan berfungsi. ## Buat ujian dalam sandbox Developer boleh membuat ujian pada merchant dashboard sandbox di [console.bayarcash-sandbox.com](https://console.bayarcash-sandbox.com), dan tiada transaksi sebenar yang berlaku. Sandbox ada API keys sendiri. Lihat [Cari API keys dan portal key anda](/ms/api-keys/). ## Isu biasa ### Kenapa saya tidak dapat log masuk? Pastikan anda guna e-mel yang anda daftarkan dengan Bayarcash. Kemudian reset password anda. Lihat Reset atau tukar password Bayarcash anda (/ms/reset-password/). ### Boleh saya log masuk ke BCL dengan akaun yang sama? Tidak. Anda log masuk secara berasingan ke merchant dashboard di console.bayar.cash dan ke BCL di bcl.my. Lihat Apa itu Bayarcash (/ms/what-is-bayarcash/). --- # Bayarcash login:登录商家后台 > Bayarcash login:用你注册的电邮和密码登录商家后台,以及无法登录时该怎么做。 > > Source: https://docs.bayarcash.com/zh/sign-in/ 登录商家后台(merchant dashboard),查看你的交易、payout、portal和API key。请使用你在Bayarcash注册的电邮地址。 ## 登录 你需要注册的电邮和密码。登录步骤: 1. 前往[console.bayar.cash/login](https://console.bayar.cash/login)。 2. 输入你的电邮和密码。 3. 点击**Login to Console**。你的后台就会打开。 *(Screenshot: Login页面,已标示Login to Console按钮)* ## 第一次登录 如果这是你第一次登录,请先设置自己的密码,然后再登录。请看[重设或更改你的Bayarcash密码](/zh/reset-password/),按照忘记密码的步骤操作。 > **Note** > 电邮地址必须是在Bayarcash注册的那一个。其他地址都不能用。 ## 在sandbox测试 开发者可以在sandbox商家后台[console.bayarcash-sandbox.com](https://console.bayarcash-sandbox.com)测试,不会产生真实交易。sandbox有自己的API key。请看[找到你的Bayarcash API key、PAT和portal key](/zh/api-keys/)。 ## 常见问题 ### 我无法登录,该怎么办? 确认你用的是在Bayarcash注册的电邮,然后重设密码。请看重设或更改你的Bayarcash密码 (/zh/reset-password/)。 ### 这和BCL是同一个登录吗? 不是。console.bayar.cash的商家后台和bcl.my的BCL要分开登录。请看什么是Bayarcash (/zh/what-is-bayarcash/)。 --- # Reset or change your Bayarcash password > Reset a forgotten password from the login page, or change your password from your profile in the merchant dashboard. > > Source: https://docs.bayarcash.com/reset-password/ You can reset a password you forgot, or change your current password from inside the merchant dashboard. Use the email address registered with Bayarcash. ## Reset a forgotten password Use this if you cannot sign in, or if it is your first time signing in. To reset: 1. Go to [console.bayar.cash/login](https://console.bayar.cash/login). 2. Choose the **Forgot password?** link. 3. Enter the email address registered with Bayarcash. 4. Open the email from Bayarcash and choose the link to reset your password. 5. Enter your email and your new password. 6. Sign in with your email and new password. Your dashboard opens. *(Screenshot: The Reset Password page with the Email field highlighted)* ## Change your password when signed in Use this if you know your password and want a new one. To change it: 1. In the merchant dashboard, choose **Profile**. The **System Profile** page opens. 2. In **Password**, type your new password. 3. In **Password Confirmation**, type the same password again. 4. Choose **Update Profile**. *(Screenshot: The System Profile section with the Password and Password Confirmation fields highlighted)* > **Caution** > Changing your password does not change your API keys. Never share your password or your keys with anyone. See [Find your API keys](/api-keys/). ## Common issues ### I did not get the reset email. Check your spam folder. Make sure you entered the email address registered with Bayarcash, because the reset email goes only to that address. ### My new password is not accepted when I update my profile. Type the same new password in both Password and Password Confirmation. If they differ, the update fails. --- # Reset atau tukar password Bayarcash anda > Reset password yang anda terlupa dari page log masuk, atau tukar password anda dari profil anda dalam merchant dashboard. > > Source: https://docs.bayarcash.com/ms/reset-password/ Anda boleh reset password yang anda terlupa, atau tukar password semasa anda dari dalam merchant dashboard. Guna alamat e-mel yang berdaftar dengan Bayarcash. ## Reset password yang terlupa Guna cara ini jika anda tidak dapat log masuk, atau jika ini kali pertama anda log masuk. Untuk reset password: 1. Pergi ke [console.bayar.cash/login](https://console.bayar.cash/login). 2. Klik link **Forgot password?**. 3. Masukkan alamat e-mel yang berdaftar dengan Bayarcash. 4. Buka e-mel daripada Bayarcash dan klik link untuk reset password anda. 5. Masukkan e-mel dan password baru anda. 6. Log masuk dengan e-mel dan password baru anda. Dashboard anda dibuka. *(Screenshot: Page Reset Password dengan ruangan Email ditanda)* ## Tukar password semasa anda sudah log masuk Guna cara ini jika anda tahu password anda dan mahu password baru. Untuk menukarnya: 1. Dalam merchant dashboard, klik **Profile**. Page **System Profile** dibuka. 2. Dalam **Password**, taip password baru anda. 3. Dalam **Password Confirmation**, taip password yang sama sekali lagi. 4. Klik **Update Profile**. *(Screenshot: Bahagian System Profile dengan ruangan Password dan Password Confirmation ditanda)* > **Caution** > Password baru tidak menukar API keys anda. Jangan kongsi password atau keys anda dengan sesiapa. Lihat [Cari API keys dan portal key anda](/ms/api-keys/). ## Isu biasa ### Kenapa saya tidak terima e-mel reset password? Semak folder spam anda. Pastikan anda masukkan alamat e-mel yang berdaftar dengan Bayarcash. E-mel reset hanya dihantar ke alamat itu. ### Kenapa password baru saya tidak diterima semasa saya kemas kini profil? Taip password baru yang sama dalam Password dan Password Confirmation. Jika kedua-duanya berbeza, profil anda tidak dikemas kini. --- # 重设或更改你的Bayarcash密码 > 在登录页面重设忘记的密码,或在商家后台的个人资料里更改密码。 > > Source: https://docs.bayarcash.com/zh/reset-password/ 你可以重设忘记的密码,或在商家后台(merchant dashboard)里更改目前的密码。请使用在Bayarcash注册的电邮地址。 ## 重设忘记的密码 如果你无法登录,或这是你第一次登录,就用这个方法。重设步骤: 1. 前往[console.bayar.cash/login](https://console.bayar.cash/login)。 2. 点击Forgot password?链接。 3. 输入在Bayarcash注册的电邮地址。 4. 打开Bayarcash发来的电邮,点击重设密码的链接。 5. 输入你的电邮和新密码。 6. 用你的电邮和新密码登录。你的商家后台会打开。 *(Screenshot: Reset Password页面,Email栏位已标示)* ## 登录后更改密码 如果你知道密码,并想换一个新密码,就用这个方法。更改步骤: 1. 在商家后台点击**Profile**。**System Profile**页面会打开。 2. 在**Password**输入新密码。 3. 在**Password Confirmation**再输入一次相同的密码。 4. 点击**Update Profile**。 *(Screenshot: System Profile部分,Password和Password Confirmation栏位已标示)* > **Caution** > 更改密码不会改变你的API key。不要把密码或key交给任何人。请看[找到你的API key](/zh/api-keys/)。 ## 常见问题 ### 我没有收到重设密码的电邮。 检查你的垃圾邮件文件夹。确认你输入的是在Bayarcash注册的电邮地址,因为重设密码的电邮只会发到这个地址。 ### 我更新个人资料时,新密码不被接受。 在Password和Password Confirmation输入相同的新密码。如果两者不同,更新会失败。 --- # Find your Bayarcash API keys, PAT and portal key > Find your Personal Access Token (PAT), API Secret Key and Portal Key in the merchant dashboard. Learn what each key does and how to keep it safe. > > Source: https://docs.bayarcash.com/api-keys/ To connect a website, shop plugin or app to Bayarcash, you need three things from the merchant dashboard: a Personal Access Token (PAT), an API Secret Key and a Portal Key. > **Caution** > Never share these keys, and never put them in a screenshot, chat message or public page. Anyone who has them can act on your Bayarcash account. If you show your screen to someone for help, hide the keys first. ## What each key does Plugins and SDKs ask for these by name: | Key | What it does | Where to find it | |---|---|---| | Personal Access Token (PAT) | Identifies your requests to Bayarcash | **Profile** → **Integration** | | API Secret Key | Signs your requests and checks the replies (the checksum) | **Profile** → **Integration** | | Portal Key | Says which portal receives the payment | **Portals** | ## Get your PAT and API Secret Key Sign in to the [merchant dashboard](/sign-in/) first. Then: 1. At the top right of the merchant dashboard, choose **Profile**. 2. Choose **Integration**. 3. Copy your Personal Access Token (PAT) and your API Secret Key. *(Screenshot: The Integration page with the Personal Access Token (PAT) and API Secret Key boxes highlighted, values hidden)* ## Get your Portal Key Each portal has its own key. To copy it: 1. At the top left of the merchant dashboard, choose **Portals**. 2. Select the portal you want to use. 3. Copy its Portal Key. *(Screenshot: The Portal Details window with the Portal Key row highlighted, value hidden)* Need a new portal first? See [Create and use portals](/portals/). ## Sandbox and live keys The sandbox merchant dashboard at [console.bayarcash-sandbox.com](https://console.bayarcash-sandbox.com) issues its own separate keys for testing. Use sandbox keys only while testing, and live keys only for real payments. For API details, see the [Bayarcash API reference](https://api-reference.bayarcash.com). ## Common issues ### Why does my plugin say the token or key is invalid? Sandbox and live keys are different. A key from the sandbox merchant dashboard does not work on the live merchant dashboard, and the other way round. Copy all three from the same merchant dashboard you are connecting to. ### Which key goes where? The Personal Access Token (PAT) identifies you to Bayarcash. The Portal Key says which portal receives the payment. The API Secret Key is used for the checksum. Plugins and SDKs ask for each one by name. ### I shared a key by mistake. What now? Contact Bayarcash straight away through the Need more help? box at the bottom of the page. Do not post the key again, even to ask for help. --- # Cari API keys, PAT & portal key Bayarcash anda > Cari Personal Access Token (PAT), API Secret Key dan Portal Key di merchant dashboard. Lihat fungsi setiap key dan cara menyimpannya dengan selamat. > > Source: https://docs.bayarcash.com/ms/api-keys/ Untuk menyambungkan laman web, plugin kedai online atau aplikasi kepada Bayarcash, anda memerlukan tiga perkara dari merchant dashboard: Personal Access Token (PAT), API Secret Key dan Portal Key. > **Caution** > Jangan kongsi keys ini dengan sesiapa. Jangan letak keys ini dalam screenshot, mesej chat atau page awam. Sesiapa yang ada keys ini boleh menggunakan akaun Bayarcash anda. Jika anda tunjuk skrin anda kepada orang lain untuk mendapatkan bantuan, sorokkan keys itu dahulu. ## Fungsi setiap key Plugin dan SDK meminta keys ini mengikut nama: | Key | Fungsi | Lokasi | |---|---|---| | Personal Access Token (PAT) | Mengenal pasti request anda kepada Bayarcash | **Profile** → **Integration** | | API Secret Key | Menandatangani request anda dan menyemak response (checksum) | **Profile** → **Integration** | | Portal Key | Menentukan portal yang menerima bayaran | **Portals** | ## Dapatkan PAT & API Secret Key anda Log masuk ke [merchant dashboard](/ms/sign-in/) dahulu. Kemudian: 1. Di bahagian atas kanan merchant dashboard, klik **Profile**. 2. Klik **Integration**. 3. Copy Personal Access Token (PAT) dan API Secret Key anda. *(Screenshot: Page Integration dengan kotak Personal Access Token (PAT) dan API Secret Key ditanda, nilainya disembunyikan)* ## Dapatkan Portal Key anda Setiap portal ada key sendiri. Untuk copy key itu: 1. Di bahagian atas kiri merchant dashboard, klik **Portals**. 2. Klik portal yang anda mahu guna. 3. Copy Portal Key portal itu. *(Screenshot: Tetingkap Portal Details dengan baris Portal Key ditanda, nilainya disembunyikan)* Perlu portal baru dahulu? Lihat [Tambah dan guna portal](/ms/portals/). ## Keys sandbox & live Merchant dashboard sandbox di [console.bayarcash-sandbox.com](https://console.bayarcash-sandbox.com) mengeluarkan keys sendiri untuk ujian. Guna keys sandbox hanya semasa ujian, dan keys live hanya untuk bayaran sebenar. Untuk butiran API, lihat [rujukan API Bayarcash](https://api-reference.bayarcash.com). ## Isu biasa ### Kenapa plugin saya kata token atau key tidak sah? Keys sandbox dan keys live adalah berbeza. Key dari merchant dashboard sandbox tidak berfungsi pada merchant dashboard live, dan sebaliknya. Copy ketiga-tiga keys dari merchant dashboard yang anda mahu sambungkan. ### Key mana untuk ruangan mana? Personal Access Token (PAT) mengenal pasti anda kepada Bayarcash. Portal Key menentukan portal yang menerima bayaran. API Secret Key digunakan untuk checksum. Plugin dan SDK meminta setiap key mengikut namanya. ### Saya terkongsi key secara tidak sengaja. Apa yang perlu saya buat? Hubungi Bayarcash dengan segera melalui kotak Need more help? di bahagian bawah page. Jangan kongsi key itu sekali lagi, walaupun semasa meminta bantuan. --- # 找到你的Bayarcash API key、PAT和portal key > 在商家后台找到Personal Access Token(PAT)、API Secret Key和Portal Key,了解每个key的用途和安全保管方法。 > > Source: https://docs.bayarcash.com/zh/api-keys/ 要把网站、网店插件或App连接到Bayarcash,你需要从商家后台(merchant dashboard)取得三样东西:Personal Access Token(PAT)、API Secret Key和Portal Key。 > **Caution** > 绝对不要分享这些key,也不要把它们放进截图、聊天信息或公开页面。任何人拿到它们,都可以操作你的Bayarcash账号。如果你向别人分享屏幕求助,请先把key遮住。 ## 每个key的用途 插件和SDK会按名称要求这些key: | Key | 用途 | 在哪里找 | |---|---|---| | Personal Access Token(PAT) | 向Bayarcash表明你的request来自你 | **Profile** → **Integration** | | API Secret Key | 为你的request签名,并检查回复(checksum) | **Profile** → **Integration** | | Portal Key | 指定由哪个portal收款 | **Portals** | ## 取得你的PAT和API Secret Key 先登录[商家后台](/zh/sign-in/)。然后: 1. 在商家后台右上方,点击**Profile**。 2. 点击**Integration**。 3. 复制你的Personal Access Token(PAT)和API Secret Key。 *(Screenshot: Integration页面,已标示Personal Access Token(PAT)和API Secret Key框,数值已隐藏)* ## 取得你的Portal Key 每个portal都有自己的key。复制步骤: 1. 在商家后台左上方,点击**Portals**。 2. 选择你要使用的portal。 3. 复制它的Portal Key。 *(Screenshot: Portal Details窗口,已标示Portal Key那一行,数值已隐藏)* 需要先创建新的portal?请看[创建和使用portal](/zh/portals/)。 ## Sandbox和正式环境的key sandbox商家后台[console.bayarcash-sandbox.com](https://console.bayarcash-sandbox.com)会另外发出专门用来测试的key。sandbox的key只在测试时使用,正式环境(production)的key只用于真实付款。 API详情请看[Bayarcash API参考文档](https://api-reference.bayarcash.com)。 ## 常见问题 ### 为什么我的插件说token或key无效? sandbox和正式环境的key不一样。sandbox商家后台的key不能在正式商家后台使用,反过来也一样。三个key都要从你要连接的同一个商家后台复制。 ### 哪个key填在哪里? Personal Access Token(PAT)向Bayarcash表明你的身份。Portal Key指定由哪个portal收款。API Secret Key用于checksum。插件和SDK会按名称要求每一个key。 ### 我不小心把key分享出去了,怎么办? 请马上通过页面底部的Need more help?框联系Bayarcash。不要再次发出这个key,即使是为了求助也不要。 --- # Turn on two-factor authentication > Add a second check to your merchant dashboard sign-in with two-factor authentication (2FA). > > Source: https://docs.bayarcash.com/two-factor-authentication/ Two-factor authentication (2FA) adds a second check when you sign in to the merchant dashboard. With 2FA, your password alone does not open your account. ## Turn on 2FA Do this for your own sign-in. Keep your phone near you. 1. Sign in to the [merchant dashboard](/sign-in/). 2. In the top menu, choose **Profile**. 3. Choose **Two-Factor Auth**. The **Two-Factor Authentication** page opens. 4. Choose **Enable Two-Factor Authentication**. 5. Follow the instructions on the screen. *(Screenshot: The Two-Factor Authentication page with the Enable Two-Factor Authentication button highlighted)* ## Tips These habits keep your account safe: - **Use a strong password that you use only for Bayarcash.** 2FA is a second lock. It does not replace a good password. See [Reset or change your password](/reset-password/). - **Turn on 2FA before you connect a shop.** Your account holds your API keys. See [Find your API keys](/api-keys/). ## Common issues ### Where do I turn on 2FA? In the top menu, choose Profile, then Two-Factor Auth. Then choose Enable Two-Factor Authentication. ### Why must I use 2FA? With 2FA, a person who knows your password still cannot sign in without the second check. --- # On-kan pengesahan dua faktor > Tambah semakan kedua semasa anda log masuk ke merchant dashboard dengan pengesahan dua faktor (2FA). > > Source: https://docs.bayarcash.com/ms/two-factor-authentication/ Pengesahan dua faktor (2FA) menambah semakan kedua apabila anda log masuk ke merchant dashboard. Dengan 2FA, password sahaja tidak cukup untuk membuka akaun anda. ## On-kan 2FA Buat langkah ini untuk log masuk anda sendiri. Pastikan telefon anda ada berdekatan. 1. Log masuk ke [merchant dashboard](/ms/sign-in/). 2. Dalam menu atas, klik **Profile**. 3. Klik **Two-Factor Auth**. Page **Two-Factor Authentication** dibuka. 4. Klik **Enable Two-Factor Authentication**. 5. Ikut arahan pada skrin. *(Screenshot: Page Two-Factor Authentication dengan butang Enable Two-Factor Authentication ditanda)* ## Tips Habit ini memastikan akaun anda selamat: - **Guna password yang kuat, khusus untuk Bayarcash sahaja.** 2FA ialah lapisan keselamatan kedua. 2FA tidak menggantikan password yang baik. Lihat [Reset atau tukar password Bayarcash anda](/ms/reset-password/). - **On-kan 2FA sebelum anda menyambungkan kedai online.** Akaun anda menyimpan API keys anda. Lihat [Cari API keys dan portal key anda](/ms/api-keys/). ## Isu biasa ### Di mana saya boleh on-kan 2FA? Dalam menu atas, klik Profile, kemudian klik Two-Factor Auth. Selepas itu, klik Enable Two-Factor Authentication. ### Kenapa saya perlu guna 2FA? Dengan 2FA, orang yang tahu password anda masih tidak boleh log masuk tanpa semakan kedua. --- # 开启双重验证 > 用双重验证(2FA)为你的商家后台登录多加一道验证。 > > Source: https://docs.bayarcash.com/zh/two-factor-authentication/ 双重验证(2FA)会在你登录商家后台(merchant dashboard)时多加一道验证。开启2FA后,单靠密码无法打开你的账号。 ## 开启2FA 为你自己的登录开启2FA。把手机放在身边。 1. 登录[商家后台](/zh/sign-in/)。 2. 在顶部菜单点击**Profile**。 3. 点击**Two-Factor Auth**。**Two-Factor Authentication**页面会打开。 4. 点击**Enable Two-Factor Authentication**。 5. 按照屏幕上的指示操作。 *(Screenshot: Two-Factor Authentication页面,Enable Two-Factor Authentication按钮已标示)* ## 小贴士 这些习惯能保护你的账号安全: - **使用一个只用于Bayarcash的强密码**。2FA是第二道锁,不能取代好的密码。请看[重设或更改你的Bayarcash密码](/zh/reset-password/)。 - **连接网店之前先开启2FA**。你的账号保存着你的API key。请看[找到你的API key](/zh/api-keys/)。 ## 常见问题 ### 在哪里开启2FA? 在顶部菜单点击Profile,然后点击Two-Factor Auth。接着点击Enable Two-Factor Authentication。 ### 为什么我必须使用2FA? 开启2FA后,即使有人知道你的密码,没有第二道验证也无法登录。 --- # Read your dashboard > The Home and Dashboard pages show your first steps, your payments, your next payout and your latest transactions. > > Source: https://docs.bayarcash.com/dashboard/ The merchant dashboard has two start pages. **Home** helps you collect your first payment. **Dashboard** shows a summary of your payments and payouts. ## Home **Home** opens with the title **Welcome** and three steps to collect your first payment. Below the steps, cards link to help: | Card | Use it to | |---|---| | **Plugin** | Find a plugin for WooCommerce, GiveWP, OpenCart, PrestaShop and other platforms | | **Platform Documentation** | Open this help centre | | **API Reference** | Read the API reference and the official SDKs | | **WhatsApp Support** | Get technical help on WhatsApp | | **Facebook** | Send a message to Bayarcash on Facebook | | **Telegram Channel** | Read announcements and updates from Bayarcash | ## Dashboard Use **Dashboard** to see the results of your business for a period. To set the period: 1. In the top menu, choose **Dashboard**. 2. Set the **Created Date Range**, or choose **Today**, **Yesterday**, **This Week** or **This Month**. 3. Choose **Filter**. To go back to the default period, choose **Reset**. *(Screenshot: The Dashboard page with the Filter button highlighted, Transaction Statistic and Payout Statistic)* The page then shows these panels: | Panel | What it shows | |---|---| | **Transaction Statistic** | The number and the total of **Successful** and **Unsuccessful** payments | | **Payout Statistic** | **Last Payout**, and **Upcoming Payout** with its cutoff time. **View All Payouts »** opens the list of payouts | | **Latest 10 Transactions** | Your 10 newest payments. **View All Transactions »** opens the full list | For more about payouts, see [Payouts to your bank account](/payouts/). ## Common issues ### How do I see the totals for this month only? On Dashboard, choose This Month next to Created Date Range, then choose Filter. ### Where do I see all my payments? Choose View All Transactions » under Latest 10 Transactions. See Check a transaction and its status (/transactions/). --- # Fahami dashboard anda > Page Home dan Dashboard memaparkan langkah pertama anda, bayaran anda, payout seterusnya dan transaksi terkini anda. > > Source: https://docs.bayarcash.com/ms/dashboard/ Merchant dashboard ada dua page utama. **Home** membantu anda menerima bayaran pertama. **Dashboard** memaparkan ringkasan bayaran dan payout anda. ## Home **Home** dibuka dengan tajuk **Welcome** dan tiga langkah untuk menerima bayaran pertama anda. Di bawah langkah itu, ada kad dengan link ke bantuan: | Kad | Guna untuk | |---|---| | **Plugin** | Cari plugin untuk WooCommerce, GiveWP, OpenCart, PrestaShop dan platform lain | | **Platform Documentation** | Buka Help Centre ini | | **API Reference** | Baca rujukan API dan SDK rasmi | | **WhatsApp Support** | Dapatkan bantuan teknikal melalui WhatsApp | | **Facebook** | Hantar mesej kepada Bayarcash di Facebook | | **Telegram Channel** | Baca pengumuman dan berita terkini daripada Bayarcash | ## Dashboard Guna **Dashboard** untuk melihat prestasi perniagaan anda bagi sesuatu tempoh. Untuk menetapkan tempoh: 1. Dalam menu atas, klik **Dashboard**. 2. Tetapkan **Created Date Range**, atau klik **Today**, **Yesterday**, **This Week** atau **This Month**. 3. Klik **Filter**. Untuk kembali ke tempoh default, klik **Reset**. *(Screenshot: Page Dashboard dengan butang Filter ditanda, serta Transaction Statistic dan Payout Statistic)* Page itu kemudian memaparkan panel ini: | Panel | Maklumat yang dipaparkan | |---|---| | **Transaction Statistic** | Bilangan dan jumlah bayaran **Successful** dan **Unsuccessful** | | **Payout Statistic** | **Last Payout**, dan **Upcoming Payout** dengan waktu cutoff-nya. **View All Payouts »** membuka senarai payout | | **Latest 10 Transactions** | 10 bayaran terbaru anda. **View All Transactions »** membuka senarai penuh | Untuk maklumat lanjut tentang payout, lihat [Payout ke akaun bank anda](/ms/payouts/). ## Isu biasa ### Bagaimana saya boleh lihat jumlah untuk bulan ini sahaja? Pada Dashboard, klik This Month di sebelah Created Date Range, kemudian klik Filter. ### Di mana saya boleh lihat semua bayaran saya? Klik View All Transactions » di bawah Latest 10 Transactions. Lihat Semak transaksi dan statusnya (/ms/transactions/). --- # 看懂你的仪表板 > Home和Dashboard页面显示你的第一步、付款、下一笔payout和最新交易。 > > Source: https://docs.bayarcash.com/zh/dashboard/ 商家后台(merchant dashboard)有两个起始页面。**Home**帮助你收到第一笔付款。**Dashboard**显示你的付款和payout(款项转入你的银行账户)摘要。 ## Home **Home**打开时显示标题**Welcome**,以及收到第一笔付款的三个步骤。步骤下方有卡片,链接到帮助资源: | 卡片 | 用途 | |---|---| | **Plugin** | 查找WooCommerce、GiveWP、OpenCart、PrestaShop和其他平台的插件 | | **Platform Documentation** | 打开这个Help Centre | | **API Reference** | 阅读API参考文档和官方SDK | | **WhatsApp Support** | 通过WhatsApp获得技术协助 | | **Facebook** | 在Facebook发信息给Bayarcash | | **Telegram Channel** | 阅读Bayarcash的公告和最新消息 | ## Dashboard 用**Dashboard**查看你的生意在某段时间的成果。设置时间段: 1. 在顶部菜单点击**Dashboard**。 2. 设置**Created Date Range**,或点击**Today**、**Yesterday**、**This Week**或**This Month**。 3. 点击**Filter**。要回到默认时间段,点击**Reset**。 *(Screenshot: Dashboard页面,Filter按钮已标示,并显示Transaction Statistic和Payout Statistic)* 页面接着显示这些面板: | 面板 | 显示内容 | |---|---| | **Transaction Statistic** | **Successful**和**Unsuccessful**付款的数量和总额 | | **Payout Statistic** | **Last Payout**,以及**Upcoming Payout**和它的截止时间。View All Payouts »会打开payout列表 | | **Latest 10 Transactions** | 你最新的10笔付款。View All Transactions »会打开完整列表 | 更多关于payout的资料,请看[转入你银行账户的payout](/zh/payouts/)。 ## 常见问题 ### 我怎样只看本月的总额? 在Dashboard,点击Created Date Range旁边的This Month,然后点击Filter。 ### 我在哪里看所有付款? 点击Latest 10 Transactions下方的View All Transactions »。请看查看交易和交易状态 (/zh/transactions/)。 --- # Create and use portals > A portal keeps the money from one shop, form or project separate in Bayarcash. Create a portal and, if needed, split a payment across accounts. > > Source: https://docs.bayarcash.com/portals/ A portal keeps the money you collect for one shop, form or project separate from the rest, so it is easier to keep track. Each portal has its own Portal Key, which your website or plugin uses to send payments to it. ## Create a portal Create a separate portal for each shop or project. To create one: 1. In the [merchant dashboard](/sign-in/), choose **Portals** at the top of the page. Your portals are listed. 2. Choose **Add New Portal**. 3. Complete the form that opens and save it. *(Screenshot: The Portals page with the Add New Portal button highlighted)* Then copy the new portal's key from **Portals**. See [Find your API keys](/api-keys/). ## Split a payment A split payment divides one payment between different accounts. When you create a portal, you can tick the split payment box. You can split between up to 3 accounts. ## Tips Simple habits make reports easier: - **Use one portal for each shop or project.** Each portal then holds only its own payments, so they are easier to match to your records. - **See the payments of one portal.** On **Transactions**, click **Advance Filter**, choose the portal in **Portal**, then click **Filter**. See [See the transactions of one portal](/transactions/#see-the-transactions-of-one-portal). - **Keep the Portal Key private.** Anyone with your keys can use your account. See [Find your API keys](/api-keys/). ## Common issues ### How many accounts can a split payment go to? Up to 3 accounts. ### Where do I copy my Portal Key? Choose Portals, select the portal, and copy its Portal Key. See Find your API keys (/api-keys/). --- # Tambah & guna portal > Tambah portal untuk mengasingkan wang setiap kedai, form atau projek dalam Bayarcash, dan bahagikan bayaran kepada beberapa akaun jika perlu. > > Source: https://docs.bayarcash.com/ms/portals/ Portal mengasingkan wang yang anda terima untuk satu kedai, form atau projek daripada wang yang lain. Ini memudahkan anda menjejak wang itu. Setiap portal ada Portal Key sendiri. Laman web atau plugin anda guna key ini untuk menghantar bayaran ke portal itu. ## Tambah portal Tambah portal yang berasingan untuk setiap kedai atau projek. Untuk menambah portal: 1. Dalam [merchant dashboard](/ms/sign-in/), klik **Portals** di bahagian atas page. Senarai portal anda dipaparkan. 2. Klik **Add New Portal**. 3. Lengkapkan form yang dibuka, kemudian simpan. *(Screenshot: Page Portals dengan butang Add New Portal ditanda)* Kemudian copy key portal baru itu dari **Portals**. Lihat [Cari API keys dan portal key anda](/ms/api-keys/). ## Split payment Split payment membahagikan satu bayaran kepada beberapa akaun yang berbeza. Semasa anda menambah portal, anda boleh tandakan kotak split payment. Anda boleh bahagikan bayaran kepada sehingga 3 akaun. ## Tips Habit mudah ini memudahkan laporan anda: - **Guna satu portal untuk setiap kedai atau projek.** Setiap portal hanya menyimpan bayarannya sendiri. Jadi bayaran itu lebih mudah dipadankan dengan rekod anda. - **Lihat bayaran bagi satu portal.** Pada **Transactions**, klik **Advance Filter**, pilih portal itu dalam **Portal**, kemudian klik **Filter**. Lihat [Lihat transaksi bagi satu portal](/ms/transactions/#lihat-transaksi-bagi-satu-portal). - **Rahsiakan Portal Key anda.** Sesiapa yang ada keys anda boleh menggunakan akaun anda. Lihat [Cari API keys dan portal key anda](/ms/api-keys/). ## Isu biasa ### Berapa banyak akaun yang boleh menerima split payment? Sehingga 3 akaun. ### Di mana saya boleh copy Portal Key saya? Klik Portals, klik portal itu, dan copy Portal Key-nya. Lihat Cari API keys dan portal key anda (/ms/api-keys/). --- # 创建和使用portal > portal把一间店、一个表单或一个项目的钱分开。创建portal,需要时把付款分到多个账户。 > > Source: https://docs.bayarcash.com/zh/portals/ portal把你为一间店、一个表单或一个项目收到的钱和其他的钱分开,方便你追踪。每个portal都有自己的Portal Key,你的网站或插件用它把付款发送到这个portal。 ## 创建portal 为每间店或每个项目创建一个独立的portal。创建步骤: 1. 在[商家后台(merchant dashboard)](/zh/sign-in/),点击页面顶部的**Portals**。页面会列出你的portal。 2. 点击**Add New Portal**。 3. 填写打开的表单,然后保存。 *(Screenshot: Portals页面,Add New Portal按钮已标示)* 然后在**Portals**复制新portal的key。请看[找到你的API key](/zh/api-keys/)。 ## 分账 分账(split payment)把一笔付款分给不同的账户。创建portal时,你可以勾选分账的方框。最多可以分给3个账户。 ## 小贴士 简单的习惯让报告更容易处理: - **每间店或每个项目用一个portal**。这样每个portal只有自己的付款,更容易和你的记录核对。 - **查看一个portal的付款**。在**Transactions**点击**Advance Filter**,在**Portal**选择该portal,然后点击**Filter**。请看[查看一个portal的交易](/zh/transactions/#查看一个portal的交易)。 - **保管好Portal Key**。任何拥有你key的人都能使用你的账号。请看[找到你的API key](/zh/api-keys/)。 ## 常见问题 ### 分账最多可以分到几个账户? 最多3个账户。 ### 我在哪里复制Portal Key? 点击Portals,选择该portal,然后复制它的Portal Key。请看找到你的API key (/zh/api-keys/)。 --- # Export data to Excel > Export a module's data from the merchant dashboard to an Excel file, then rename, download or delete the file. > > Source: https://docs.bayarcash.com/export-module-data/ You can export the data of a merchant dashboard module to an Excel file. Use it when you want your own copy, or want to work on the data in a spreadsheet. ## Export your data Sign in to the [merchant dashboard](/sign-in/) first. Then: 1. In the top menu of the merchant dashboard, choose **Tools**. 2. Choose **Excel Export** to export your module data in Excel format. 3. The **Excel Exports** page opens and lists your exported files. *(Screenshot: The Tools page with the Excel Export button highlighted)* ## Rename, download or delete a file On the **Excel Exports** page, each file has buttons. Use them to: - Edit the file name. - Download the file to your computer. - Delete the file. *(Screenshot: The Excel Exports page with the edit, download and delete buttons of a file highlighted)* > **Caution** > An exported file can contain customer details. Keep it private and delete it when you no longer need it. ## Common issues ### Where do I find a file I exported earlier? Choose Tools, then Excel Export. The Excel Exports page lists your exported files. ### Can I remove an exported file? Yes. On the Excel Exports page, use the delete button for that file. --- # Export data ke Excel > Export data sesuatu modul dari merchant dashboard ke fail Excel, kemudian tukar nama, muat turun atau padam fail itu. > > Source: https://docs.bayarcash.com/ms/export-module-data/ Anda boleh export data sesuatu modul merchant dashboard ke fail Excel. Guna fungsi ini apabila anda mahu salinan sendiri, atau mahu mengolah data itu dalam spreadsheet. ## Export data anda Log masuk ke [merchant dashboard](/ms/sign-in/) dahulu. Kemudian: 1. Dalam menu atas merchant dashboard, klik **Tools**. 2. Klik **Excel Export** untuk export data modul anda dalam format Excel. 3. Page **Excel Exports** dibuka dan menyenaraikan fail yang anda export. *(Screenshot: Page Tools dengan butang Excel Export ditanda)* ## Tukar nama, muat turun atau padam fail Pada page **Excel Exports**, setiap fail ada beberapa butang. Guna butang itu untuk: - Edit nama fail. - Muat turun fail ke komputer anda. - Padam fail. *(Screenshot: Page Excel Exports dengan butang edit, muat turun dan padam bagi satu fail ditanda)* > **Caution** > Fail yang di-export boleh mengandungi butiran pelanggan. Simpan fail itu dengan selamat, dan padam fail itu apabila anda tidak memerlukannya lagi. ## Isu biasa ### Di mana saya boleh cari fail yang saya export sebelum ini? Klik Tools, kemudian klik Excel Export. Page Excel Exports menyenaraikan fail yang anda export. ### Boleh saya padam fail yang sudah di-export? Boleh. Pada page Excel Exports, klik butang padam bagi fail itu. --- # 把资料导出到Excel > 把商家后台某个模块的资料导出成Excel文件,然后重新命名、下载或删除文件。 > > Source: https://docs.bayarcash.com/zh/export-module-data/ 你可以把商家后台(merchant dashboard)模块的资料导出成Excel文件。当你想保留自己的副本,或想在电子表格里处理资料时,就用这个功能。 ## 导出你的资料 先登录[商家后台](/zh/sign-in/)。然后: 1. 在商家后台的顶部菜单点击**Tools**。 2. 点击**Excel Export**,以Excel格式导出你的模块资料。 3. **Excel Exports**页面会打开,列出你导出的文件。 *(Screenshot: Tools页面,Excel Export按钮已标示)* ## 重新命名、下载或删除文件 在**Excel Exports**页面,每个文件都有按钮。用这些按钮: - 编辑文件名称。 - 把文件下载到你的电脑。 - 删除文件。 *(Screenshot: Excel Exports页面,一个文件的编辑、下载和删除按钮已标示)* > **Caution** > 导出的文件可能包含顾客资料。请妥善保管文件,不再需要时就删除。 ## 常见问题 ### 我在哪里找之前导出的文件? 点击Tools,然后点击Excel Export。Excel Exports页面会列出你导出的文件。 ### 我可以删除导出的文件吗? 可以。在Excel Exports页面,点击该文件的删除按钮。 --- # Request a split payment for a portal > A split payment sends one payment to up to 3 merchants. Request it for a portal from the Edit Portal page. > > Source: https://docs.bayarcash.com/split-payments/ A split payment divides one customer payment between more than one merchant. You set it for each portal. The Bayarcash Payout team checks each request and approves it by hand. The portal can split payments only after the approval. ## Request a split payment Do this for the portal that must split its payments. 1. Sign in to the [merchant dashboard](/sign-in/). 2. In the top menu, choose **Portals**, then choose **Portals** again. 3. In the **Action** column of the portal, choose the icon **Edit portal**. The **Edit Portal** page opens. 4. Find **Enable Split Payment?**. You cannot tick this box yourself. 5. Choose **Request for Split Payment**. 6. Follow the instructions on the screen. *(Screenshot: The Edit Portal page with Enable Split Payment? and Request for Split Payment highlighted)* Below the box, the **Split Payment Details** section says: "Maximum up to 3 merchants allowed for split payment." ## Follow your requests and split payouts Two other screens show split payments: - **Portals** → **Split Payments** in the top menu opens the page for split payment applications. If your account does not have split payments, this page shows "Access denied." - On the **Payouts** page, **Advance Filter** has a **Payout Type** filter. Choose **Split Payout** to see only the payouts from split payments. See [Payouts to your bank account](/payouts/). To create a portal, see [Create and use portals](/portals/). ## Common issues ### How many merchants can share one payment? Up to 3. The Edit Portal page says: "Maximum up to 3 merchants allowed for split payment." ### The Enable Split Payment? box is grey. Why? You cannot tick it yourself. Choose Request for Split Payment next to it to ask Bayarcash to turn it on. --- # Mohon split payment untuk portal > Split payment membahagikan satu bayaran kepada sehingga 3 merchant, dan anda memohonnya bagi sesuatu portal dari page Edit Portal. > > Source: https://docs.bayarcash.com/ms/split-payments/ Split payment membahagikan satu bayaran pelanggan kepada lebih daripada satu merchant. Anda tetapkan split payment bagi setiap portal. Team Payout Bayarcash menyemak setiap permohonan dan meluluskannya secara manual. Portal itu hanya boleh membuat split payment selepas permohonan diluluskan. ## Mohon split payment Buat langkah ini untuk portal yang perlu membahagikan bayarannya. 1. Log masuk ke [merchant dashboard](/ms/sign-in/). 2. Dalam menu atas, klik **Portals**, kemudian klik **Portals** sekali lagi. 3. Dalam lajur **Action** bagi portal itu, klik ikon **Edit portal**. Page **Edit Portal** dibuka. 4. Cari **Enable Split Payment?**. Anda tidak boleh tandakan kotak ini sendiri. 5. Klik **Request for Split Payment**. 6. Ikut arahan pada skrin. *(Screenshot: Page Edit Portal dengan Enable Split Payment? dan Request for Split Payment ditanda)* Di bawah kotak itu, bahagian **Split Payment Details** menyatakan: "Maximum up to 3 merchants allowed for split payment." ## Jejak permohonan & payout split anda Dua skrin lain memaparkan split payment: - **Portals** → **Split Payments** dalam menu atas membuka page permohonan split payment. Jika akaun anda tiada split payment, page ini memaparkan "Access denied." - Pada page **Payouts**, **Advance Filter** ada filter **Payout Type**. Klik **Split Payout** untuk melihat payout daripada split payment sahaja. Lihat [Payout ke akaun bank anda](/ms/payouts/). Untuk menambah portal, lihat [Tambah dan guna portal](/ms/portals/). ## Isu biasa ### Berapa banyak merchant yang boleh berkongsi satu bayaran? Sehingga 3. Page Edit Portal menyatakan: "Maximum up to 3 merchants allowed for split payment." ### Kenapa kotak Enable Split Payment? berwarna grey? Anda tidak boleh tandakan kotak itu sendiri. Klik Request for Split Payment di sebelahnya untuk meminta Bayarcash on-kan fungsi itu. --- # 为portal申请分账 > 分账把一笔付款分给最多3个商家。在Edit Portal页面为portal提出申请。 > > Source: https://docs.bayarcash.com/zh/split-payments/ 分账(split payment)把顾客的一笔付款分给多于一个商家。你为每个portal分别设置分账。Bayarcash Payout团队会检查每个申请,并人工批准。portal要在批准后才能分账。 ## 申请分账 为需要分账的portal进行以下步骤。 1. 登录[商家后台(merchant dashboard)](/zh/sign-in/)。 2. 在顶部菜单点击**Portals**,然后再点击一次**Portals**。 3. 在该portal的**Action**列,点击**Edit portal**图标。**Edit Portal**页面会打开。 4. 找到**Enable Split Payment?**。你不能自己勾选这个方框。 5. 点击**Request for Split Payment**。 6. 按照屏幕上的指示操作。 *(Screenshot: Edit Portal页面,Enable Split Payment?和Request for Split Payment已标示)* 方框下方的**Split Payment Details**部分写着:“Maximum up to 3 merchants allowed for split payment.” ## 跟进你的申请和分账payout 另外两个画面也显示分账: - 顶部菜单的**Portals** → **Split Payments**会打开分账申请页面。如果你的账号没有分账功能,这个页面会显示“Access denied.” - 在**Payouts**页面,**Advance Filter**有**Payout Type**筛选。点击**Split Payout**,只查看来自分账的payout。请看[转入你银行账户的payout](/zh/payouts/)。 要创建portal,请看[创建和使用portal](/zh/portals/)。 ## 常见问题 ### 一笔付款最多可以分给几个商家? 最多3个。Edit Portal页面写着:“Maximum up to 3 merchants allowed for split payment.” ### Enable Split Payment?方框是灰色的,为什么? 你不能自己勾选。点击旁边的Request for Split Payment,请Bayarcash为你开启。 --- # Use the Tools page > What each card on the Tools page of the merchant dashboard does, from the fees report and Excel exports to the checkers and the webhook log. > > Source: https://docs.bayarcash.com/tools/ The **Tools** page collects the extra functions of the merchant dashboard. To open it, choose **Tools** in the top menu. *(Screenshot: The Tools page with its eight cards)* ## The cards on the Tools page Each card has a short text and a button: | Button | What it does | |---|---| | **Fees Report** | Shows the fees of your successful transactions, sorted by portal | | **Excel Export** | Lists the Excel files of module data that you exported. See [Export data to Excel](/export-module-data/) | | **Download Receipt** | Shows old receipts of wallet reloads. The wallet is no longer in use | | **Download Statement** | A monthly account statement. The card shows **COMING SOON** | | **Payment Link** | Opens BCL (its old name is Bayarcash Link), to make a payment link and send it to a customer. See [What is Bayarcash](/what-is-bayarcash/) | | **e-Mandate Checker** | Opens the public e-Mandate checker for Direct Debit. See [Check a payment or an e-Mandate without signing in](/public-checkers/) | | **Transaction Checker** | Opens the public transaction checker. See [Check a payment or an e-Mandate without signing in](/public-checkers/) | | **Webhook Log** | Shows the callbacks that Bayarcash sent to your website. See [Check your webhook log](/webhook-log/) | ## Read the fees report Use the fees report to match the fees with your own records. 1. On **Tools**, choose **Fees Report**. The **Successful Transaction Fees** page opens. 2. Read the list. It shows **Created**, **Portal**, **Trx. Reference Number**, **Transaction Amount** and **Fees Amount** for each transaction. The page also shows **Wallet Balance** and **Reload »**. They are from the old wallet, which is no longer in use. Bayarcash will remove them. For the fees of your package, see [Check your package subscription](/package-subscriptions/). ## Common issues ### Where do I see the fees for each transaction? On Tools, choose Fees Report. It lists the fees of your successful transactions, sorted by portal. ### Download Statement does not open. The card shows COMING SOON. It is not available yet. --- # Guna page Tools > Fungsi setiap kad pada page Tools dalam merchant dashboard, termasuk laporan caj, export Excel, checker dan webhook log. > > Source: https://docs.bayarcash.com/ms/tools/ Page **Tools** mengumpulkan fungsi tambahan merchant dashboard. Untuk membuka page ini, klik **Tools** dalam menu atas. *(Screenshot: Page Tools dengan lapan kadnya)* ## Kad pada page Tools Setiap kad ada teks pendek dan satu butang: | Butang | Fungsi | |---|---| | **Fees Report** | Memaparkan caj bagi transaksi anda yang berjaya, mengikut portal | | **Excel Export** | Menyenaraikan fail Excel data modul yang anda export. Lihat [Export data ke Excel](/ms/export-module-data/) | | **Download Receipt** | Memaparkan resit lama bagi top-up wallet. Wallet tidak lagi digunakan | | **Download Statement** | Penyata akaun bulanan. Kad ini memaparkan **COMING SOON** | | **Payment Link** | Membuka BCL (nama lamanya Bayarcash Link) untuk membuat payment link dan menghantarnya kepada pelanggan. Lihat [Apa itu Bayarcash](/ms/what-is-bayarcash/) | | **e-Mandate Checker** | Membuka checker e-Mandate awam untuk Direct Debit. Lihat [Semak bayaran atau e-Mandate tanpa log masuk](/ms/public-checkers/) | | **Transaction Checker** | Membuka checker transaksi awam. Lihat [Semak bayaran atau e-Mandate tanpa log masuk](/ms/public-checkers/) | | **Webhook Log** | Memaparkan callback yang Bayarcash hantar ke laman web anda. Lihat [Semak webhook log anda](/ms/webhook-log/) | ## Semak laporan caj Guna laporan caj untuk memadankan caj dengan rekod anda sendiri. 1. Pada **Tools**, klik **Fees Report**. Page **Successful Transaction Fees** dibuka. 2. Semak senarai itu. Senarai ini memaparkan **Created**, **Portal**, **Trx. Reference Number**, **Transaction Amount** dan **Fees Amount** bagi setiap transaksi. Page ini juga memaparkan **Wallet Balance** dan **Reload »**. Kedua-duanya daripada wallet lama, yang tidak lagi digunakan. Bayarcash akan membuang kedua-duanya. Untuk caj pakej anda, lihat [Semak langganan pakej anda](/ms/package-subscriptions/). ## Isu biasa ### Di mana saya boleh lihat caj bagi setiap transaksi? Pada Tools, klik Fees Report. Laporan ini menyenaraikan caj bagi transaksi anda yang berjaya, mengikut portal. ### Kenapa Download Statement tidak dibuka? Kad itu memaparkan COMING SOON. Fungsi ini belum tersedia. --- # 使用Tools页面 > 商家后台Tools页面上每张卡片的用途,包括手续费报告、Excel导出、查询工具和webhook记录。 > > Source: https://docs.bayarcash.com/zh/tools/ **Tools**页面集合了商家后台(merchant dashboard)的额外功能。要打开它,在顶部菜单点击**Tools**。 *(Screenshot: Tools页面和它的八张卡片)* ## Tools页面上的卡片 每张卡片都有一段简短文字和一个按钮: | 按钮 | 用途 | |---|---| | **Fees Report** | 按portal显示你成功交易的手续费 | | **Excel Export** | 列出你导出的模块资料Excel文件。请看[把资料导出到Excel](/zh/export-module-data/) | | **Download Receipt** | 显示钱包充值的旧收据。钱包已经停用 | | **Download Statement** | 每月账户结单。这张卡片显示**COMING SOON** | | **Payment Link** | 打开BCL(旧名Bayarcash Link),创建付款链接并发送给顾客。请看[什么是Bayarcash](/zh/what-is-bayarcash/) | | **e-Mandate Checker** | 打开Direct Debit的公开e-Mandate查询页面。请看[无需登录查询付款、e-Mandate或银行](/zh/public-checkers/) | | **Transaction Checker** | 打开公开的交易查询页面。请看[无需登录查询付款、e-Mandate或银行](/zh/public-checkers/) | | **Webhook Log** | 显示Bayarcash发送到你网站的callback。请看[查看你的webhook记录](/zh/webhook-log/) | ## 查看手续费报告 用手续费报告把手续费和你自己的记录核对。 1. 在**Tools**,点击**Fees Report**。**Successful Transaction Fees**页面会打开。 2. 查看列表。它显示每笔交易的**Created**、**Portal**、**Trx. Reference Number**、**Transaction Amount**和**Fees Amount**。 页面也显示**Wallet Balance**和**Reload »**。它们来自已经停用的旧钱包。Bayarcash会把它们移除。 你配套的手续费,请看[查看你的配套订阅](/zh/package-subscriptions/)。 ## 常见问题 ### 我在哪里看每笔交易的手续费? 在Tools,点击Fees Report。它按portal列出你成功交易的手续费。 ### Download Statement打不开。 这张卡片显示COMING SOON,目前还不能使用。 --- # Update your profile > Change your sign-in email, password and contact person in Profile, and see the organisation details that Bayarcash keeps for you. > > Source: https://docs.bayarcash.com/profile/ The **Profile** page holds the details of your merchant dashboard account and of your organisation. You can change some of them. Your account manager changes the others. ## Change your email, password or contact person Do this when a staff member leaves, or when you want a new password. 1. In the top menu, choose **Profile**, then choose **Profile** again. 2. In **System Profile**, change **Email** if necessary. 3. To set a new password, type it in **Password** and in **Password Confirmation**. 4. In **User Profile**, change **Contact Person** if necessary. 5. Choose **Update Profile**. *(Screenshot: The Profile page with the System Profile fields and the Update Profile button highlighted)* ## Details that only Bayarcash can change The **User Profile** section shows your organisation details. These fields are grey, and you cannot change them: | Field | What it holds | |---|---| | **Organisation Name** | The name of your registered business | | **Registration Number** | Your business registration number | | **Telephone Number** and **Email** | The contact details of your organisation | | **Address** | Your business address | The page says: "Please contact your account manager for any changes in address & organisation details." The **Name** in **System Profile** is also grey. To see the bank account that receives your payouts, see [Check your payout bank account](/payout-bank/). ## Common issues ### How do I change my company address or registration number? You cannot change them in the merchant dashboard. Contact your account manager. The User Profile section also says this. ### How do I change my password? On Profile, type the new password in Password and in Password Confirmation. Then choose Update Profile. --- # Kemas kini profil anda > Tukar e-mel log masuk, password dan contact person anda dalam Profile, dan lihat butiran organisasi yang Bayarcash simpan untuk anda. > > Source: https://docs.bayarcash.com/ms/profile/ Page **Profile** menyimpan butiran akaun merchant dashboard dan butiran organisasi anda. Anda boleh menukar sebahagian butiran ini. Account manager anda menukar butiran yang lain. ## Tukar e-mel, password atau contact person anda Buat langkah ini apabila seorang staf berhenti, atau apabila anda mahu password baru. 1. Dalam menu atas, klik **Profile**, kemudian klik **Profile** sekali lagi. 2. Dalam **System Profile**, tukar **Email** jika perlu. 3. Untuk menetapkan password baru, taip password itu dalam **Password** dan dalam **Password Confirmation**. 4. Dalam **User Profile**, tukar **Contact Person** jika perlu. 5. Klik **Update Profile**. *(Screenshot: Page Profile dengan ruangan System Profile dan butang Update Profile ditanda)* ## Butiran yang hanya Bayarcash boleh tukar Bahagian **User Profile** memaparkan butiran organisasi anda. Ruangan ini berwarna grey, dan anda tidak boleh menukarnya: | Ruangan | Kandungan | |---|---| | **Organisation Name** | Nama perniagaan berdaftar anda | | **Registration Number** | Nombor pendaftaran perniagaan anda | | **Telephone Number** dan **Email** | Butiran hubungan organisasi anda | | **Address** | Alamat perniagaan anda | Page ini menyatakan: "Please contact your account manager for any changes in address & organisation details." **Name** dalam **System Profile** juga berwarna grey. Untuk melihat akaun bank yang menerima payout anda, lihat [Semak akaun bank untuk payout anda](/ms/payout-bank/). ## Isu biasa ### Bagaimana saya boleh tukar alamat atau nombor pendaftaran syarikat saya? Anda tidak boleh menukarnya dalam merchant dashboard. Hubungi account manager anda. Bahagian User Profile juga menyatakan perkara ini. ### Bagaimana saya boleh tukar password saya? Pada Profile, taip password baru dalam Password dan dalam Password Confirmation. Kemudian klik Update Profile. --- # 更新你的个人资料 > 在Profile更改登录电邮、密码和联系人,并查看Bayarcash为你保存的机构资料。 > > Source: https://docs.bayarcash.com/zh/profile/ **Profile**页面保存你的商家后台(merchant dashboard)账号资料和机构资料。有些资料你可以自己更改,其他资料由你的客户经理更改。 ## 更改电邮、密码或联系人 员工离职,或你想换新密码时,按以下步骤操作。 1. 在顶部菜单点击**Profile**,然后再点击一次**Profile**。 2. 在**System Profile**,按需要更改**Email**。 3. 要设置新密码,在**Password**和**Password Confirmation**输入新密码。 4. 在**User Profile**,按需要更改**Contact Person**。 5. 点击**Update Profile**。 *(Screenshot: Profile页面,System Profile栏位和Update Profile按钮已标示)* ## 只有Bayarcash能更改的资料 **User Profile**部分显示你的机构资料。这些栏位是灰色的,你不能更改: | 栏位 | 内容 | |---|---| | **Organisation Name** | 你的注册公司名称 | | **Registration Number** | 你的公司注册号码 | | **Telephone Number**和**Email** | 你的机构联系资料 | | **Address** | 你的公司地址 | 页面上写着:“Please contact your account manager for any changes in address & organisation details.”**System Profile**里的**Name**也是灰色的。 要查看接收payout的银行账户,请看[查看你的payout银行账户](/zh/payout-bank/)。 ## 常见问题 ### 我怎样更改公司地址或注册号码? 你不能在商家后台更改这些资料。请联系你的客户经理。User Profile部分也有这样说明。 ### 我怎样更改密码? 在Profile页面,在Password和Password Confirmation输入新密码,然后点击Update Profile。 --- # Find your Bayarcash invoices > See the invoices for your package subscription, with their period, due date and tax, under Profile and Billing. > > Source: https://docs.bayarcash.com/invoices/ The **Invoices** page lists the invoices for your package subscription. Use it for your accounts, or to check a due date. ## Open your invoices To see the list of invoices: 1. Sign in to the [merchant dashboard](/sign-in/). 2. In the top menu, choose **Profile**. 3. Choose **Billing**. The **Invoices** page opens. 4. To find one invoice, choose **Advance Filter**. Then set the **Created Date Range** or the **Period**. *(Screenshot: The Invoices page with Advance Filter open and highlighted)* The list has these columns: | Column | What it shows | |---|---| | **Created** | The date of the record | | **Status** | The status of the invoice | | **Period** | The period that the invoice is for | | **Invoice Date** and **Due Date** | The date of the invoice, and the last day to pay it | | **Subtotal**, **Tax Amount** and **Total Amount** | The amount before tax, the tax, and the amount to pay | To keep a copy of the list, choose **Export Excel**. To get the newest data, choose **Reload**. For your package and its period, see [Check your package subscription](/package-subscriptions/). ## Common issues ### Where are my Bayarcash invoices? In the top menu, choose Profile, then Billing. The Invoices page lists them. ### Can I keep a copy of the invoice list? Yes. On the Invoices page, choose Export Excel. --- # Cari invois Bayarcash anda > Lihat invois langganan pakej anda di bawah Profile dan Billing, termasuk tempoh, tarikh akhir bayaran dan cukai setiap invois. > > Source: https://docs.bayarcash.com/ms/invoices/ Page **Invoices** menyenaraikan invois bagi langganan pakej anda. Guna page ini untuk rekod akaun anda, atau untuk menyemak tarikh akhir bayaran. ## Buka invois anda Untuk melihat senarai invois: 1. Log masuk ke [merchant dashboard](/ms/sign-in/). 2. Dalam menu atas, klik **Profile**. 3. Klik **Billing**. Page **Invoices** dibuka. 4. Untuk mencari satu invois, klik **Advance Filter**. Kemudian tetapkan **Created Date Range** atau **Period**. *(Screenshot: Page Invoices dengan Advance Filter terbuka dan ditanda)* Senarai ini ada lajur berikut: | Lajur | Maklumat | |---|---| | **Created** | Tarikh rekod itu dibuat | | **Status** | Status invois | | **Period** | Tempoh yang diliputi oleh invois | | **Invoice Date** dan **Due Date** | Tarikh invois, dan hari terakhir untuk membayarnya | | **Subtotal**, **Tax Amount** dan **Total Amount** | Amaun sebelum cukai, amaun cukai, dan amaun yang perlu dibayar | Untuk menyimpan salinan senarai ini, klik **Export Excel**. Untuk mendapatkan data terkini, klik **Reload**. Untuk pakej anda dan tempohnya, lihat [Semak langganan pakej anda](/ms/package-subscriptions/). ## Isu biasa ### Di mana saya boleh cari invois Bayarcash saya? Dalam menu atas, klik Profile, kemudian klik Billing. Page Invoices menyenaraikan invois anda. ### Boleh saya simpan salinan senarai invois? Boleh. Pada page Invoices, klik Export Excel. --- # 找到你的Bayarcash发票 > 在Profile和Billing下查看你配套订阅的发票,包括期间、到期日和税额。 > > Source: https://docs.bayarcash.com/zh/invoices/ **Invoices**页面列出你配套订阅的发票。你可以用它来做账,或查看到期日。 ## 打开你的发票 查看发票列表: 1. 登录[商家后台(merchant dashboard)](/zh/sign-in/)。 2. 在顶部菜单选择**Profile**。 3. 选择**Billing**。**Invoices**页面会打开。 4. 如果要找一张发票,选择**Advance Filter**。然后设置**Created Date Range**或**Period**。 *(Screenshot: Invoices页面,Advance Filter已打开并已标示)* 列表有这些列: | 列 | 显示什么 | |---|---| | **Created** | 记录的日期 | | **Status** | 发票的状态 | | **Period** | 发票所属的期间 | | **Invoice Date**和**Due Date** | 发票日期,以及付款的最后一天 | | **Subtotal**、**Tax Amount**和**Total Amount** | 税前金额、税额,以及要付的金额 | 如果要保存这个列表,选择**Export Excel**。如果要获取最新资料,选择**Reload**。 关于你的配套和它的期间,请看[查看你的配套订阅](/zh/package-subscriptions/)。 ## 常见问题 ### 我的Bayarcash发票在哪里? 在顶部菜单选择Profile,然后选择Billing。Invoices页面会列出你的发票。 ### 我可以保存发票列表吗? 可以。在Invoices页面选择Export Excel。 --- # Check your package subscription > See your Bayarcash package, its start and end dates, your payout schedule and your fee details under Profile and Subscriptions. > > Source: https://docs.bayarcash.com/package-subscriptions/ The **Package Subscriptions** page shows your current package and the old ones. The details of each one show the package period, the payout schedule and the fee details. ## Open your subscriptions To see your package: 1. Sign in to the [merchant dashboard](/sign-in/). 2. In the top menu, choose **Profile**. 3. Choose **Subscriptions**. The **Package Subscriptions** page opens. *(Screenshot: The Package Subscriptions page with the status boxes and the list)* The boxes at the top count your subscriptions in each status: **Inactive**, **Active**, **Expired** and **Cancelled**. Your current package has the status **Active**. The list shows the **Type**, the **Package**, the **Subscription Start** and the **Subscription End** of each one. ## Read the details of a subscription Do this to find your payout schedule and your fees. 1. In the **Action** column, choose the icon **View subscription details**. The **Subscription Details** window opens. 2. Read the three tabs: | Tab | What it shows | |---|---| | **Merchant** | Your business name and the bank account for your payouts | | **Subscription** | The **Package**, the **Subscription Period**, the **Subscription Start** and the **Subscription Expired** dates | | **Payout & Fees** | The **Payout Schedule** and the **Per Successful Transaction Fee Details** for each payment channel | 3. Choose **Close**. *(Screenshot: The Subscription Details window on the Payout & Fees tab, fee figures blurred)* > **Note** > The fees and the payout schedule can be different for each merchant. Always read your own figures in this window. For the general rule, see [Payout settlement schedule](/payout-schedule/). ## Common issues ### Where do I see my own payout schedule? Open Profile → Subscriptions. Open the Active subscription and read Payout Schedule on the Payout & Fees tab. ### Where do I see the fees for my account? On the Payout & Fees tab of your Active subscription. The fees can be different for each merchant, so always read them there. --- # Semak langganan pakej anda > Lihat pakej Bayarcash anda, tarikh mula dan tamatnya, jadual payout dan butiran caj anda di bawah Profile dan Subscriptions. > > Source: https://docs.bayarcash.com/ms/package-subscriptions/ Page **Package Subscriptions** memaparkan pakej semasa anda dan pakej lama anda. Butiran setiap pakej menunjukkan tempoh pakej, jadual payout dan butiran caj. ## Buka langganan anda Untuk melihat pakej anda: 1. Log masuk ke [merchant dashboard](/ms/sign-in/). 2. Dalam menu atas, klik **Profile**. 3. Klik **Subscriptions**. Page **Package Subscriptions** dibuka. *(Screenshot: Page Package Subscriptions dengan kotak status dan senarai langganan)* Kotak di bahagian atas menunjukkan bilangan langganan anda bagi setiap status: **Inactive**, **Active**, **Expired** dan **Cancelled**. Pakej semasa anda berstatus **Active**. Senarai ini memaparkan **Type**, **Package**, **Subscription Start** dan **Subscription End** bagi setiap langganan. ## Semak butiran langganan Buat langkah ini untuk mencari jadual payout dan caj anda. 1. Dalam lajur **Action**, klik ikon **View subscription details**. Tetingkap **Subscription Details** dibuka. 2. Semak tiga tab ini: | Tab | Maklumat | |---|---| | **Merchant** | Nama perniagaan anda dan akaun bank untuk payout anda | | **Subscription** | **Package**, **Subscription Period**, serta tarikh **Subscription Start** dan **Subscription Expired** | | **Payout & Fees** | **Payout Schedule** dan **Per Successful Transaction Fee Details** bagi setiap saluran bayaran | 3. Klik **Close**. *(Screenshot: Tetingkap Subscription Details pada tab Payout & Fees, dengan angka caj dikaburkan)* > **Note** > Caj dan jadual payout boleh berbeza bagi setiap merchant. Sentiasa semak angka anda sendiri dalam tetingkap ini. Untuk peraturan umum, lihat [Jadual payout](/ms/payout-schedule/). ## Isu biasa ### Di mana saya boleh lihat jadual payout saya? Buka Profile → Subscriptions. Buka langganan yang berstatus Active dan semak Payout Schedule pada tab Payout & Fees. ### Di mana saya boleh lihat caj untuk akaun saya? Pada tab Payout & Fees bagi langganan Active anda. Caj boleh berbeza bagi setiap merchant, jadi sentiasa semak caj anda di situ. --- # 查看你的配套订阅 > 在Profile和Subscriptions查看你的Bayarcash配套、开始和结束日期、payout时间表和手续费详情。 > > Source: https://docs.bayarcash.com/zh/package-subscriptions/ **Package Subscriptions**页面显示你目前的配套和以前的配套。每个配套的详情显示配套期限、payout时间表和手续费详情。 ## 打开你的订阅 查看你的配套: 1. 登录[商家后台(merchant dashboard)](/zh/sign-in/)。 2. 在顶部菜单点击**Profile**。 3. 点击**Subscriptions**。**Package Subscriptions**页面会打开。 *(Screenshot: Package Subscriptions页面,显示状态方框和列表)* 顶部的方框显示每个状态的订阅数量:**Inactive**、**Active**、**Expired**和**Cancelled**。你目前的配套状态是**Active**。 列表显示每个订阅的**Type**、**Package**、**Subscription Start**和**Subscription End**。 ## 查看订阅详情 用这个方法找出你的payout时间表和手续费。 1. 在**Action**列,点击**View subscription details**图标。**Subscription Details**窗口会打开。 2. 查看三个标签页: | 标签页 | 显示内容 | |---|---| | **Merchant** | 你的公司名称和接收payout的银行账户 | | **Subscription** | **Package**、**Subscription Period**,以及**Subscription Start**和**Subscription Expired**日期 | | **Payout & Fees** | **Payout Schedule**,以及每个付款渠道的**Per Successful Transaction Fee Details** | 3. 点击**Close**。 *(Screenshot: Subscription Details窗口的Payout & Fees标签页,手续费数字已模糊处理)* > **Note** > 每个商家的手续费和payout时间表可能不同。请一定在这个窗口查看你自己的数字。一般规则请看[Payout结算时间表](/zh/payout-schedule/)。 ## 常见问题 ### 我在哪里看自己的payout时间表? 打开Profile → Subscriptions。打开Active的订阅,在Payout & Fees标签页查看Payout Schedule。 ### 我在哪里看我账号的手续费? 在你Active订阅的Payout & Fees标签页。每个商家的手续费可能不同,所以请一定在那里查看。 --- # Payment channels you can accept with Bayarcash > The payment channels Bayarcash offers, what each one is for, and which ones you need to switch on for a portal before customers can use them. > > Source: https://docs.bayarcash.com/payment-channels/ Bayarcash lets your customers pay by online banking, QR, e-wallet, card and buy now pay later, from one account. This page lists each channel and how it is switched on. ## How channels are switched on A channel works only when it is switched on for the portal that takes the payment. FPX online banking is on by default. Every other channel needs to be enabled for the portal first. To turn channels on: 1. Sign in to the merchant dashboard. 2. Open **Portals**. Tick the channels you want when you create a portal with **Add New Portal**. 3. If a channel is not in the list, or you need it on an existing portal, ask the Bayarcash team to switch it on for that portal. *(Screenshot: The Payment Channel section of the Add New Portal form, with the channels grouped by type)* Your shop or form then offers the channels of the portal key you connect to it. See [Portals](/portals/) and [API keys](/api-keys/). ## Channels The ID is the number developers send as `payment_channel` in the API. | ID | Channel | Use it for | |---|---|---| | | **Online banking** | | | 1 | FPX Personal Banking (B2C) | Online banking from Malaysian banks. On by default. | | 23 | FPX Business Banking (B2B) | Company (business) online banking. | | 4 | FPX Line of Credit (CCA) | Paying with a bank credit facility. See [FPX Line of Credit](/fpx-line-of-credit/). | | 5 | DuitNow Online Banking/Wallets (DOBW) | Real-time payment from a bank app or e-wallet. | | | **Recurring** | | | 3 | Direct Debit | Recurring collection after an e-mandate. See [Direct Debit transactions](/direct-debit-transactions/). | | | **Cards** | | | 12 | Cards (Visa, Mastercard, MyDebit) | Card payments. | | | **DuitNow QR** | | | 6 | DuitNow QR | Customers scan a QR code with their banking app or e-wallet. | | | **Cross-border QR** | | | 9 | QRIS Indonesia (online banking) | Customers from Indonesia who pay with a bank app. See [Cross-border channels](/cross-border-channels/). | | 10 | QRIS Indonesia (e-wallet) | Customers from Indonesia who pay with an e-wallet. | | 11 | NETS | Customers from Singapore. | | 13 | Alipay | Customers from China who pay with Alipay. | | 14 | WeChat Pay | Customers from China who pay with WeChat Pay. | | 15 | PromptPay | Customers from Thailand. | | | **E-wallets** | | | 16 | Touch 'n Go eWallet | Touch 'n Go eWallet. | | 17 | Boost Wallet | Boost e-wallet. | | 18 | GrabPay | Grab e-wallet. | | 21 | ShopeePay | ShopeePay e-wallet. | | | **Buy now, pay later** | | | 7 | SPayLater | Buy now pay later with SPayLater. | | 8 | Boost PayFlex | Buy now pay later with Boost PayFlex. | | 19 | PayLater by Grab | Buy now pay later with Grab. | Manual Bank Transfer also exists as a channel: the customer transfers the money themselves to a bank account you list on the portal. ## Which channels does my shop show? Your platform can show fewer channels than your portal has. Some plugins let you turn each method on or off, or pick a channel per form. Check the plugin's guide, for example [WooCommerce](/woocommerce/), or set the channel in your API request. See the [API reference](https://api-reference.bayarcash.com). ## Tips - **Use one portal per shop.** It keeps each shop's channels and payments separate for reconciliation. - **Test in sandbox first.** Sandbox and live have separate portals, so switch channels on in both. ## Common issues ### A payment channel does not show at checkout. Why? Only channels switched on for the portal you use will work. FPX is on by default. Ask Bayarcash to switch on the other channels, or tick them when you create a portal (see Portals (/portals/)), then check the portal key in your shop or form is the right one. ### What does the API say when I use a channel that is not enabled? Only channels enabled on your account will work. Use a channel ID from the table below and check it is switched on for that portal. Details are in the API reference (https://api-reference.bayarcash.com). ### Can I use Direct Debit on any portal? Direct Debit is a separate flow with its own e-mandate steps. See Direct Debit transactions (/direct-debit-transactions/). ### How much does Bayarcash charge for each channel, for example a credit card payment? See the standard fee of each channel, and work out what you receive from a sale, in the Payout calculator (/payout-calculator/). For plans, see the pricing on bayarcash.com (https://bayarcash.com/#pricing). Bayarcash deducts the fees from each transaction before the payout. Your agreement with Bayarcash can have different rates. --- # Saluran bayaran yang boleh anda terima melalui Bayarcash > Saluran bayaran dalam Bayarcash, kegunaan setiap satu, dan saluran yang perlu di-on-kan untuk portal sebelum pelanggan boleh membayar. > > Source: https://docs.bayarcash.com/ms/payment-channels/ Dengan Bayarcash, pelanggan anda boleh membayar melalui online banking, QR, e-wallet, kad dan buy now pay later, semuanya dalam satu akaun. Page ini menyenaraikan setiap saluran dan cara saluran itu di-on-kan. ## Cara saluran di-on-kan Sesuatu saluran hanya berfungsi apabila saluran itu di-on-kan untuk portal yang menerima bayaran. FPX online banking sudah on secara default. Saluran lain perlu di-on-kan untuk portal itu dahulu. Untuk on-kan saluran: 1. Log masuk ke merchant dashboard. 2. Buka **Portals**. Semasa anda membuat portal dengan **Add New Portal**, tandakan saluran yang anda mahu. 3. Jika sesuatu saluran tiada dalam senarai, atau anda perlukannya pada portal yang sudah ada, minta Bayarcash on-kan saluran itu untuk portal tersebut. *(Screenshot: Bahagian Payment Channel dalam form Add New Portal, dengan saluran dikumpulkan mengikut jenis)* Kedai atau form anda akan menawarkan saluran yang ada pada portal key yang disambungkan kepadanya. Lihat [Portal](/ms/portals/) dan [API keys](/ms/api-keys/). ## Saluran ID ialah nombor yang developer hantar sebagai `payment_channel` dalam API. | ID | Saluran | Guna untuk | |---|---|---| | | **Online banking** | | | 1 | FPX Personal Banking (B2C) | Online banking dari bank Malaysia. On secara default. | | 23 | FPX Business Banking (B2B) | Online banking untuk akaun syarikat (perniagaan). | | 4 | FPX Line of Credit (CCA) | Bayaran dengan kemudahan kredit bank. Lihat [FPX Line of Credit](/ms/fpx-line-of-credit/). | | 5 | DuitNow Online Banking/Wallets (DOBW) | Bayaran serta-merta dari aplikasi perbankan atau e-wallet. | | | **Bayaran berulang** | | | 3 | Direct Debit | Kutipan berulang selepas e-mandate. Lihat [Transaksi Direct Debit](/ms/direct-debit-transactions/). | | | **Kad** | | | 12 | Cards (Visa, Mastercard, MyDebit) | Bayaran dengan kad. | | | **DuitNow QR** | | | 6 | DuitNow QR | Pelanggan scan kod QR dengan aplikasi perbankan atau e-wallet mereka. | | | **QR cross-border** | | | 9 | QRIS Indonesia (online banking) | Pelanggan dari Indonesia yang membayar dengan aplikasi perbankan. Lihat [Saluran bayaran cross-border](/ms/cross-border-channels/). | | 10 | QRIS Indonesia (e-wallet) | Pelanggan dari Indonesia yang membayar dengan e-wallet. | | 11 | NETS | Pelanggan dari Singapura. | | 13 | Alipay | Pelanggan dari China yang membayar dengan Alipay. | | 14 | WeChat Pay | Pelanggan dari China yang membayar dengan WeChat Pay. | | 15 | PromptPay | Pelanggan dari Thailand. | | | **E-wallet** | | | 16 | Touch 'n Go eWallet | Touch 'n Go eWallet. | | 17 | Boost Wallet | E-wallet Boost. | | 18 | GrabPay | E-wallet Grab. | | 21 | ShopeePay | E-wallet ShopeePay. | | | **Buy now, pay later** | | | 7 | SPayLater | Buy now pay later dengan SPayLater. | | 8 | Boost PayFlex | Buy now pay later dengan Boost PayFlex. | | 19 | PayLater by Grab | Buy now pay later dengan Grab. | Manual Bank Transfer juga ada sebagai saluran. Pelanggan memindahkan wang sendiri ke akaun bank yang anda senaraikan pada portal. ## Saluran mana yang dipaparkan oleh kedai saya? Platform anda mungkin tidak memaparkan semua saluran yang ada pada portal anda. Sesetengah plugin membolehkan anda on-kan atau off-kan setiap kaedah bayaran, atau memilih saluran untuk setiap form. Semak panduan plugin itu, contohnya [WooCommerce](/ms/woocommerce/), atau tetapkan saluran dalam API request anda. Lihat [API reference](https://api-reference.bayarcash.com). ## Tips Dua habit ini memudahkan kerja anda: - **Guna satu portal untuk satu kedai.** Saluran dan bayaran setiap kedai kekal berasingan, jadi reconciliation lebih mudah. - **Uji dalam sandbox dahulu.** Sandbox dan live ada portal yang berasingan, jadi on-kan saluran dalam kedua-duanya. ## Isu biasa ### Kenapa sesuatu saluran bayaran tidak dipaparkan semasa checkout? Hanya saluran yang di-on-kan untuk portal anda akan berfungsi. FPX sudah on secara default. Minta Bayarcash on-kan saluran lain, atau tandakan saluran itu semasa anda membuat portal (lihat Portal (/ms/portals/)). Kemudian pastikan portal key dalam kedai atau form anda ialah portal key yang betul. ### Apa yang API pulangkan jika saya guna saluran yang belum di-on-kan? Hanya saluran yang di-on-kan pada akaun anda akan berfungsi. Guna ID saluran daripada jadual di bawah, dan pastikan saluran itu di-on-kan untuk portal tersebut. Butirannya ada dalam API reference (https://api-reference.bayarcash.com). ### Boleh saya guna Direct Debit pada mana-mana portal? Direct Debit ialah proses yang berasingan, dengan langkah e-mandate tersendiri. Lihat Transaksi Direct Debit (/ms/direct-debit-transactions/). ### Berapa caj Bayarcash untuk setiap saluran, contohnya untuk bayaran kad kredit? Guna Kalkulator payout (/ms/payout-calculator/) untuk melihat caj standard setiap saluran dan mengira amaun yang anda terima daripada satu jualan. Untuk pelan, lihat harga di bayarcash.com (https://bayarcash.com/#pricing). Bayarcash menolak caj daripada setiap transaksi sebelum payout. Perjanjian anda dengan Bayarcash boleh ada rate yang berbeza. --- # 你可以用Bayarcash接受的付款渠道 > Bayarcash提供的付款渠道、各自的用途,以及哪些渠道要先为portal开启,顾客才能使用。 > > Source: https://docs.bayarcash.com/zh/payment-channels/ 有了Bayarcash,你的顾客可以用网上银行、QR码、电子钱包、卡和先买后付付款,全部在同一个账号里。本页列出每个渠道,以及如何开启。 ## 渠道如何开启 渠道只有在收款的portal上开启后才能使用。FPX网上银行默认开启。其他渠道都要先为portal开启。 开启渠道的步骤: 1. 登录商家后台(merchant dashboard)。 2. 打开**Portals**。用**Add New Portal**创建portal时,勾选你要的渠道。 3. 如果列表里没有某个渠道,或你要在现有的portal上使用它,请Bayarcash团队为那个portal开启。 *(Screenshot: Add New Portal表单的Payment Channel部分,渠道按类型分组)* 之后,你的网店或表单会提供所连接portal key的渠道。请看[Portal](/zh/portals/)和[API key](/zh/api-keys/)。 ## 渠道 ID是开发者在API里以`payment_channel`发送的号码。 | ID | 渠道 | 用途 | |---|---|---| | | **Online banking** | | | 1 | FPX Personal Banking (B2C) | 马来西亚银行的网上银行。默认开启。 | | 23 | FPX Business Banking (B2B) | 公司(企业)网上银行。 | | 4 | FPX Line of Credit (CCA) | 用银行信贷额度付款。请看[FPX Line of Credit](/zh/fpx-line-of-credit/)。 | | 5 | DuitNow Online Banking/Wallets (DOBW) | 从银行App或电子钱包即时付款。 | | | **定期付款** | | | 3 | Direct Debit | 完成e-Mandate后的定期收款。请看[Direct Debit交易](/zh/direct-debit-transactions/)。 | | | **卡** | | | 12 | Cards (Visa, Mastercard, MyDebit) | 卡付款。 | | | **DuitNow QR** | | | 6 | DuitNow QR | 顾客用银行App或电子钱包扫描QR码。 | | | **跨境QR码** | | | 9 | QRIS Indonesia (online banking) | 用银行App付款的印尼顾客。请看[跨境付款渠道](/zh/cross-border-channels/)。 | | 10 | QRIS Indonesia (e-wallet) | 用电子钱包付款的印尼顾客。 | | 11 | NETS | 新加坡顾客。 | | 13 | Alipay | 用Alipay付款的中国顾客。 | | 14 | WeChat Pay | 用WeChat Pay付款的中国顾客。 | | 15 | PromptPay | 泰国顾客。 | | | **电子钱包** | | | 16 | Touch 'n Go eWallet | Touch 'n Go eWallet。 | | 17 | Boost Wallet | Boost电子钱包。 | | 18 | GrabPay | Grab电子钱包。 | | 21 | ShopeePay | ShopeePay电子钱包。 | | | **Buy now, pay later** | | | 7 | SPayLater | 用SPayLater先买后付。 | | 8 | Boost PayFlex | 用Boost PayFlex先买后付。 | | 19 | PayLater by Grab | 用Grab先买后付。 | Manual Bank Transfer也是一个渠道:顾客自己把钱转到你在portal上列出的银行账户。 ## 我的网店会显示哪些渠道? 你的平台显示的渠道可能比portal上的少。有些插件让你逐一开启或关闭每种付款方式,或为每个表单选择渠道。请查看该插件的指南,例如[WooCommerce](/zh/woocommerce/),或在你的API request里设置渠道。请看[API参考文档](https://api-reference.bayarcash.com)。 ## 小贴士 - **一个网店用一个portal**。这样每个网店的渠道和付款都分开,方便对账。 - **先在sandbox测试**。sandbox和正式环境的portal是分开的,所以两边都要开启渠道。 ## 常见问题 ### 某个付款渠道没有出现在结账页面,为什么? 只有为你所用的portal开启的渠道才能使用。FPX默认开启。请Bayarcash为你开启其他渠道,或在创建portal时勾选它们(请看Portal (/zh/portals/)),然后检查你网店或表单里的portal key是否正确。 ### 如果我用了没有开启的渠道,API会怎么回应? 只有你账号上已开启的渠道才能使用。请使用下表中的渠道ID,并检查该渠道已为那个portal开启。详情请看API参考文档 (https://api-reference.bayarcash.com)。 ### 我可以在任何portal使用Direct Debit吗? Direct Debit是另一套流程,有自己的e-Mandate步骤。请看Direct Debit交易 (/zh/direct-debit-transactions/)。 ### Bayarcash每个渠道收多少手续费?例如信用卡付款? 在Payout计算器 (/zh/payout-calculator/)可以看到每个渠道的标准手续费,并算出一笔销售你会收到多少。配套请看bayarcash.com上的价格 (https://bayarcash.com/#pricing)。Bayarcash会在payout前从每笔交易扣除手续费。你与Bayarcash的协议可能有不同的费率。 --- # How your customer pays with DuitNow QR > The screens your customer sees when they pay by DuitNow QR with ShopeePay, GrabPay, Boost, Touch 'n Go, Setel, BigPay or buy now pay later. > > Source: https://docs.bayarcash.com/duitnow-qr-payment-steps/ With DuitNow QR, your customer scans one QR code with their banking app or e-wallet and pays you. These are the screens of the most common e-wallets. Use them to help a customer who asks how to pay. The screens are examples from August 2024. The app makers can change their screens. The shop name, amounts and numbers in the pictures are samples. ## E-wallets In each e-wallet, the customer does the same 3 things: 1. Scan the DuitNow QR code at your checkout or counter. 2. Check that the shop name and the amount are correct. 3. Confirm the payment. Some apps ask for a PIN, a fingerprint or a face scan. The app then shows that the payment is successful. Bayarcash sends the result to your shop, and the payment shows in [Transactions](/transactions/). ### ShopeePay On **Pay To**, the customer checks the shop name and the amount and taps **Next**. On **Confirm Payment**, they choose **Wallet Balance** and tap **Pay Now**. *(Screenshot: ShopeePay: the Pay To screen with RM 1.00, then the Confirm Payment screen with Wallet Balance selected)* ### GrabPay The customer checks the shop name and the amount, then slides **Pay**. GrabPay then shows that the shop received the payment. *(Screenshot: GrabPay: the pay screen with the shop name and 1.00, then the receipt with GrabPay Wallet as the payment method)* ### Boost Wallet On **Amount**, the customer chooses **Pay Now** and taps **Pay RM 1.00**. On **Confirm Payment**, they enter their PIN or tap **Use Touch ID**. Boost then shows **SUCCESS**. *(Screenshot: Boost Wallet: the Amount screen with Pay Now selected, the Confirm Payment window and the SUCCESS screen)* ### Touch 'n Go eWallet On **Pay**, the customer checks the shop name and the amount and taps **Confirm**. The receipt shows **DuitNow QR** as the transaction type. They tap **Done**. *(Screenshot: Touch 'n Go eWallet: the Pay screen with the shop name and RM 1.00, then the Paid receipt)* ### Setel On **Enter payment amount**, the customer checks the amount and taps **PAY · RM1.00**. Setel then shows **Payment successful**. *(Screenshot: Setel: the Enter payment amount screen, then the Payment successful screen)* ### BigPay The customer checks the amount and taps **Send**. BigPay then shows **DuitNow QR successful**. The screen below is from 2024 and shows an empty amount field. With a Bayarcash QR, the amount is already in the QR. *(Screenshot: BigPay: the amount screen with the shop name, then the DuitNow QR successful receipt)* ## Buy now, pay later Your customer can also scan the DuitNow QR code and pay later in instalments. The steps start the same as an e-wallet payment. > **Not a direct pay later channel** > For you, this is a normal DuitNow QR payment. You get the full amount, at the DuitNow QR fee. Through DuitNow QR, the SPayLater maximum is RM 1,000 for each payment. See [Buy now, pay later through DuitNow QR](/pay-later-duitnow-qr/). ### SPayLater SPayLater is in the ShopeePay app. 1. On **Pay To**, the customer checks the amount and taps **Next**. 2. On **Confirm Payment**, they choose **SPayLater**. 3. They choose a plan, for example **1 Month** or **Instalment 3X**, and tap **Select**. 4. They tap **Pay Now**. *(Screenshot: SPayLater: the Pay To screen with RM 80.00, the SPayLater plans, and the Confirm Payment screen with SPayLater selected)* ### Boost PayFlex Boost PayFlex is in the Boost app. 1. On **Amount**, the customer chooses **Pay in 30 days** or **Pay In Instalments**, then the number of instalments. They tap **Next**. 2. On **Payment Summary**, they read the instalment dates and amounts and tick the agreement box. 3. They confirm with their face, or tap **Use PIN**. 4. Boost shows **SUCCESS**. *(Screenshot: Boost PayFlex: the Amount screen with Pay In Instalments selected, the Payment Summary with 3 instalments, and the SUCCESS screen)* ## Common issues ### My customer uses an app that is not in this guide. Can they pay? Yes, if the app can scan a DuitNow QR code. The steps are almost the same: scan, check your shop name and the amount, then confirm. ### My customer paid, but I cannot see the payment. Where do I look? Open Transactions in the merchant dashboard and look for the payment. See Transactions (/transactions/). If the payment failed, see Why did my payment fail? (/payment-failed/). --- # Cara pelanggan anda membayar dengan DuitNow QR > Skrin yang pelanggan nampak semasa membayar dengan DuitNow QR melalui ShopeePay, GrabPay, Boost, Touch 'n Go, Setel, BigPay atau buy now pay later. > > Source: https://docs.bayarcash.com/ms/duitnow-qr-payment-steps/ Dengan DuitNow QR, pelanggan anda scan satu kod QR dengan app perbankan atau e-wallet mereka, dan terus membayar anda. Panduan ini menunjukkan skrin bagi e-wallet yang paling biasa digunakan. Guna panduan ini untuk membantu pelanggan yang bertanya cara membayar. Skrin ini ialah contoh dari Ogos 2024. Pembuat app boleh menukar skrin mereka. Nama kedai, amaun dan nombor dalam gambar ialah contoh sahaja. ## E-wallet Dalam setiap e-wallet, pelanggan membuat 3 perkara yang sama: 1. Scan kod DuitNow QR di checkout atau kaunter anda. 2. Semak bahawa nama kedai dan amaun itu betul. 3. Sahkan bayaran. Sesetengah app meminta PIN, cap jari atau imbasan muka. App itu kemudian menunjukkan bahawa bayaran berjaya. Bayarcash menghantar keputusan itu ke kedai anda, dan bayaran itu dipaparkan dalam [Transactions](/ms/transactions/). ### ShopeePay Pada **Pay To**, pelanggan menyemak nama kedai dan amaun, kemudian klik **Next**. Pada **Confirm Payment**, pelanggan memilih **Wallet Balance** dan klik **Pay Now**. *(Screenshot: ShopeePay: skrin Pay To dengan RM 1.00, kemudian skrin Confirm Payment dengan Wallet Balance dipilih)* ### GrabPay Pelanggan menyemak nama kedai dan amaun, kemudian leret **Pay**. GrabPay kemudian menunjukkan bahawa kedai itu sudah menerima bayaran. *(Screenshot: GrabPay: skrin bayaran dengan nama kedai dan 1.00, kemudian resit dengan GrabPay Wallet sebagai kaedah bayaran)* ### Boost Wallet Pada **Amount**, pelanggan memilih **Pay Now** dan klik **Pay RM 1.00**. Pada **Confirm Payment**, pelanggan memasukkan PIN atau klik **Use Touch ID**. Boost kemudian memaparkan **SUCCESS**. *(Screenshot: Boost Wallet: skrin Amount dengan Pay Now dipilih, tetingkap Confirm Payment dan skrin SUCCESS)* ### Touch 'n Go eWallet Pada **Pay**, pelanggan menyemak nama kedai dan amaun, kemudian klik **Confirm**. Resit menunjukkan **DuitNow QR** sebagai jenis transaksi. Pelanggan klik **Done**. *(Screenshot: Touch 'n Go eWallet: skrin Pay dengan nama kedai dan RM 1.00, kemudian resit Paid)* ### Setel Pada **Enter payment amount**, pelanggan menyemak amaun dan klik **PAY · RM1.00**. Setel kemudian memaparkan **Payment successful**. *(Screenshot: Setel: skrin Enter payment amount, kemudian skrin Payment successful)* ### BigPay Pelanggan menyemak amaun dan klik **Send**. BigPay kemudian memaparkan **DuitNow QR successful**. Skrin di bawah ialah dari tahun 2024 dan ruangan amaunnya kosong. Dengan QR Bayarcash, amaun itu sudah ada dalam QR. *(Screenshot: BigPay: skrin amaun dengan nama kedai, kemudian resit DuitNow QR successful)* ## Buy now, pay later Pelanggan anda juga boleh scan kod DuitNow QR dan membayar kemudian secara ansuran. Langkah awalnya sama seperti bayaran e-wallet. > **Bukan saluran pay later terus** > Bagi anda, ini ialah bayaran DuitNow QR biasa. Anda menerima amaun penuh, dengan caj DuitNow QR. Melalui DuitNow QR, had SPayLater ialah RM 1,000 bagi setiap bayaran. Lihat [Buy now, pay later melalui DuitNow QR](/ms/pay-later-duitnow-qr/). ### SPayLater SPayLater ada dalam app ShopeePay. 1. Pada **Pay To**, pelanggan menyemak amaun dan klik **Next**. 2. Pada **Confirm Payment**, pelanggan memilih **SPayLater**. 3. Pelanggan memilih pelan, contohnya **1 Month** atau **Instalment 3X**, dan klik **Select**. 4. Pelanggan klik **Pay Now**. *(Screenshot: SPayLater: skrin Pay To dengan RM 80.00, pelan SPayLater, dan skrin Confirm Payment dengan SPayLater dipilih)* ### Boost PayFlex Boost PayFlex ada dalam app Boost. 1. Pada **Amount**, pelanggan memilih **Pay in 30 days** atau **Pay In Instalments**, kemudian bilangan ansuran. Pelanggan klik **Next**. 2. Pada **Payment Summary**, pelanggan membaca tarikh dan amaun ansuran, dan menandakan kotak persetujuan. 3. Pelanggan mengesahkan dengan muka mereka, atau klik **Use PIN**. 4. Boost memaparkan **SUCCESS**. *(Screenshot: Boost PayFlex: skrin Amount dengan Pay In Instalments dipilih, Payment Summary dengan 3 ansuran, dan skrin SUCCESS)* ## Isu biasa ### Bolehkah pelanggan saya membayar dengan app yang tiada dalam panduan ini? Boleh, jika app itu boleh scan kod DuitNow QR. Langkahnya hampir sama: scan, semak nama kedai dan amaun, kemudian sahkan bayaran. ### Pelanggan saya sudah membayar, tetapi saya tidak nampak bayaran itu. Di mana saya perlu semak? Buka Transactions dalam merchant dashboard dan cari bayaran itu. Lihat Semak transaksi dan statusnya (/ms/transactions/). Jika bayaran itu gagal, lihat Kenapa bayaran saya gagal? (/ms/payment-failed/). --- # 顾客如何用DuitNow QR付款 > 顾客用ShopeePay、GrabPay、Boost、Touch 'n Go、Setel、BigPay或先买后付,以DuitNow QR付款时看到的画面。 > > Source: https://docs.bayarcash.com/zh/duitnow-qr-payment-steps/ 使用DuitNow QR,顾客用自己的银行App或电子钱包扫描一个QR码,就可以付款给你。以下是最常用电子钱包的画面。当顾客问你怎样付款时,可以用这些画面帮助他们。 这些画面是2024年8月的例子。App开发商可能会更改画面。图片里的商店名称、金额和号码都是示例。 ## 电子钱包 在每个电子钱包里,顾客都做同样的3件事: 1. 在你的结账页面或柜台扫描DuitNow QR码。 2. 检查商店名称和金额是否正确。 3. 确认付款。有些App会要求输入PIN、指纹或人脸扫描。 App接着会显示付款成功。Bayarcash会把结果发送到你的商店,这笔付款也会显示在[Transactions](/zh/transactions/)里。 ### ShopeePay 在**Pay To**画面,顾客检查商店名称和金额,然后点击**Next**。在**Confirm Payment**画面,他们选择**Wallet Balance**,然后点击**Pay Now**。 *(Screenshot: ShopeePay:显示RM 1.00的Pay To画面,然后是已选择Wallet Balance的Confirm Payment画面)* ### GrabPay 顾客检查商店名称和金额,然后滑动**Pay**。GrabPay接着会显示商店已经收到付款。 *(Screenshot: GrabPay:显示商店名称和1.00的付款画面,然后是付款方式为GrabPay Wallet的收据)* ### Boost Wallet 在**Amount**画面,顾客选择**Pay Now**,然后点击**Pay RM 1.00**。在**Confirm Payment**画面,他们输入PIN或点击**Use Touch ID**。Boost接着会显示**SUCCESS**。 *(Screenshot: Boost Wallet:已选择Pay Now的Amount画面、Confirm Payment窗口和SUCCESS画面)* ### Touch 'n Go eWallet 在**Pay**画面,顾客检查商店名称和金额,然后点击**Confirm**。收据会显示交易类型为**DuitNow QR**。他们点击**Done**。 *(Screenshot: Touch 'n Go eWallet:显示商店名称和RM 1.00的Pay画面,然后是Paid收据)* ### Setel 在**Enter payment amount**画面,顾客检查金额,然后点击**PAY · RM1.00**。Setel接着会显示**Payment successful**。 *(Screenshot: Setel:Enter payment amount画面,然后是Payment successful画面)* ### BigPay 顾客检查金额,然后点击**Send**。BigPay接着会显示**DuitNow QR successful**。下面的画面来自2024年,金额栏位是空的。使用Bayarcash的QR码时,金额已经在QR码里。 *(Screenshot: BigPay:显示商店名称的金额画面,然后是DuitNow QR successful收据)* ## 先买后付 顾客也可以扫描DuitNow QR码,之后再分期付款。开始的步骤和电子钱包付款一样。 > **不是直接的先买后付渠道** > 对你来说,这是一笔普通的DuitNow QR付款。你会收到全额,并支付DuitNow QR的手续费。通过DuitNow QR付款时,SPayLater每笔付款的上限是RM 1,000。请看[通过DuitNow QR先买后付](/zh/pay-later-duitnow-qr/)。 ### SPayLater SPayLater在ShopeePay App里。 1. 在**Pay To**画面,顾客检查金额,然后点击**Next**。 2. 在**Confirm Payment**画面,他们选择**SPayLater**。 3. 他们选择一个方案,例如**1 Month**或**Instalment 3X**,然后点击**Select**。 4. 他们点击**Pay Now**。 *(Screenshot: SPayLater:显示RM 80.00的Pay To画面、SPayLater方案,以及已选择SPayLater的Confirm Payment画面)* ### Boost PayFlex Boost PayFlex在Boost App里。 1. 在**Amount**画面,顾客选择**Pay in 30 days**或**Pay In Instalments**,然后选择分期次数。他们点击**Next**。 2. 在**Payment Summary**画面,他们查看每期的日期和金额,然后勾选同意框。 3. 他们用人脸确认,或点击**Use PIN**。 4. Boost显示**SUCCESS**。 *(Screenshot: Boost PayFlex:已选择Pay In Instalments的Amount画面、分3期的Payment Summary,以及SUCCESS画面)* ## 常见问题 ### 我的顾客用的App不在这份指南里。他们可以付款吗? 可以,只要这个App能扫描DuitNow QR码。步骤差不多一样:扫描,检查商店名称和金额,然后确认。 ### 顾客已经付款,但我看不到这笔付款。我要看哪里? 在商家后台打开Transactions,找这笔付款。请看查看交易和交易状态 (/zh/transactions/)。如果付款失败,请看为什么我的付款失败? (/zh/payment-failed/)。 --- # Buy now, pay later through DuitNow QR > How SPayLater and Boost PayFlex work when your customer scans your DuitNow QR code, and how this differs from a direct pay later channel. > > Source: https://docs.bayarcash.com/pay-later-duitnow-qr/ Your customer can pay in instalments with SPayLater or Boost PayFlex when they scan your DuitNow QR code. You do not set up anything new: if your portal accepts DuitNow QR, your customer can already do this. ## How it works The customer chooses the instalment plan inside their own app, after the scan: 1. Your checkout shows your DuitNow QR code. 2. The customer scans it with the ShopeePay app or the Boost app. 3. In the app, they choose **SPayLater** or **Boost PayFlex** and an instalment plan. 4. They confirm the payment in the app. You get a DuitNow QR payment for the full amount. The instalments are between your customer and the provider. To see each app screen, see [How your customer pays with DuitNow QR](/duitnow-qr-payment-steps/#buy-now-pay-later). ## Through DuitNow QR or a direct channel A direct pay later channel is a separate channel on your checkout. This table shows the differences: | | Through DuitNow QR | Direct pay later channel | |---|---|---| | Setup | Nothing to set up. It works with DuitNow QR. | Apply to Bayarcash first. | | Where the customer chooses the plan | In their app, after the scan | On your checkout | | Your fee | The DuitNow QR fee only. The customer pays any instalment charge to the provider. | The pay later fee | | Limit for each payment | SPayLater: maximum RM 1,000. Boost PayFlex: no fixed maximum at the moment, but Boost can change this. | Higher, up to the customer's full limit | | Plans on your checkout | Not shown | Shown | The fees for each channel are on the [Payout calculator](/payout-calculator/) page. ## Which one to use Pay later through DuitNow QR costs you nothing extra, and it needs no setup. SPayLater through DuitNow QR stops at RM 1,000. For a larger amount, the customer must use another way to pay. Boost PayFlex has no fixed maximum at the moment. The provider can change its limits at any time. A direct pay later channel suits higher amounts, and it shows pay later on your checkout. You can use both: keep DuitNow QR on, and add a direct channel when your customers buy larger items. ## Tips - **Do not promise a pay later limit to your customers.** SPayLater stops at RM 1,000 through DuitNow QR. The providers can change their limits, and each customer's own limit can be lower. - **Tell your customers about pay later in their app.** Your checkout shows only the DuitNow QR code. Many customers do not know about this option. ## Common issues ### My customer has SPayLater, but the option does not show when they scan my QR code. Why? Through DuitNow QR, the maximum for SPayLater is RM 1,000 for each payment. For a larger amount, or if the customer's own limit is lower, the app shows no SPayLater option. The customer can pay with their wallet balance or a bank account instead. ### Do I pay a pay later fee when my customer uses SPayLater through DuitNow QR? No. You get the full amount as a DuitNow QR payment, at the DuitNow QR fee. The customer pays any instalment charge to the provider. See Payout calculator (/payout-calculator/) for the fees. --- # Buy now, pay later melalui DuitNow QR > Cara SPayLater dan Boost PayFlex berfungsi apabila pelanggan scan kod DuitNow QR anda, dan bezanya dengan saluran pay later terus. > > Source: https://docs.bayarcash.com/ms/pay-later-duitnow-qr/ Pelanggan anda boleh membayar secara ansuran dengan SPayLater atau Boost PayFlex apabila mereka scan kod DuitNow QR anda. Anda tidak perlu membuat sebarang tetapan baru. Jika portal anda menerima DuitNow QR, pelanggan anda sudah boleh membayar dengan cara ini. ## Cara bayaran ini dibuat Pelanggan memilih pelan ansuran dalam app mereka sendiri, selepas scan kod itu: 1. Checkout anda memaparkan kod DuitNow QR anda. 2. Pelanggan scan kod itu dengan app ShopeePay atau app Boost. 3. Dalam app, pelanggan memilih **SPayLater** atau **Boost PayFlex** dan pelan ansuran. 4. Pelanggan mengesahkan bayaran dalam app. Anda menerima bayaran DuitNow QR untuk amaun penuh. Ansuran itu urusan antara pelanggan anda dan penyedia. Untuk melihat setiap skrin app, lihat [Cara pelanggan anda membayar dengan DuitNow QR](/ms/duitnow-qr-payment-steps/#buy-now-pay-later). ## Melalui DuitNow QR atau saluran terus Saluran pay later terus ialah saluran berasingan pada checkout anda. Jadual ini menunjukkan bezanya: | | Melalui DuitNow QR | Saluran pay later terus | |---|---|---| | Setup | Tiada setup. Terus berfungsi dengan DuitNow QR. | Mohon kepada Bayarcash dahulu. | | Tempat pelanggan memilih pelan | Dalam app mereka, selepas scan | Pada checkout anda | | Caj anda | Caj DuitNow QR sahaja. Jika ada caj ansuran, pelanggan membayarnya kepada penyedia. | Caj pay later | | Had bagi setiap bayaran | SPayLater: maksimum RM 1,000. Boost PayFlex: tiada had maksimum tetap buat masa ini, tetapi Boost boleh mengubahnya. | Lebih tinggi, sehingga had penuh pelanggan | | Pelan pada checkout anda | Tidak dipaparkan | Dipaparkan | Caj bagi setiap saluran ada pada page [Kalkulator payout](/ms/payout-calculator/). ## Mana satu yang sesuai Pay later melalui DuitNow QR tidak menambah kos anda, dan tidak perlu setup. SPayLater melalui DuitNow QR terhad kepada RM 1,000. Untuk amaun yang lebih besar, pelanggan mesti membayar dengan cara lain. Boost PayFlex tiada had maksimum tetap buat masa ini. Penyedia boleh mengubah had mereka pada bila-bila masa. Saluran pay later terus sesuai untuk amaun yang lebih tinggi, dan checkout anda memaparkan pilihan pay later. Anda boleh guna kedua-duanya. Biarkan DuitNow QR on, dan tambah saluran terus apabila pelanggan anda membeli barang yang lebih mahal. ## Tips - **Jangan janjikan had pay later kepada pelanggan.** SPayLater terhad kepada RM 1,000 melalui DuitNow QR. Penyedia boleh mengubah had mereka, dan had setiap pelanggan mungkin lebih rendah. - **Beritahu pelanggan tentang pay later dalam app mereka.** Checkout anda hanya memaparkan kod DuitNow QR. Ramai pelanggan tidak tahu tentang pilihan ini. ## Isu biasa ### Pelanggan saya ada SPayLater, tetapi pilihan itu tidak dipaparkan apabila mereka scan kod QR saya. Kenapa? Melalui DuitNow QR, had SPayLater ialah RM 1,000 bagi setiap bayaran. Jika amaun lebih besar, atau had SPayLater pelanggan itu lebih rendah, app tidak memaparkan pilihan SPayLater. Pelanggan boleh membayar dengan baki e-wallet atau akaun bank. ### Adakah saya membayar caj pay later apabila pelanggan menggunakan SPayLater melalui DuitNow QR? Tidak. Anda menerima amaun penuh sebagai bayaran DuitNow QR, dengan caj DuitNow QR. Jika ada caj ansuran, pelanggan membayarnya kepada penyedia. Lihat Kalkulator payout (/ms/payout-calculator/) untuk caj. --- # 通过DuitNow QR先买后付 > 顾客扫描你的DuitNow QR码时如何用SPayLater和Boost PayFlex付款,以及和直接先买后付渠道的分别。 > > Source: https://docs.bayarcash.com/zh/pay-later-duitnow-qr/ 顾客扫描你的DuitNow QR码时,可以用SPayLater或Boost PayFlex分期付款。你不需要做任何新设置:只要你的portal接受DuitNow QR,顾客就已经可以这样付款。 ## 运作方式 顾客扫描后,在自己的App里选择分期计划: 1. 你的结账页面显示你的DuitNow QR码。 2. 顾客用ShopeePay App或Boost App扫描。 3. 在App里,他们选择**SPayLater**或**Boost PayFlex**和分期计划。 4. 他们在App里确认付款。 你会收到一笔全额的DuitNow QR付款。分期是顾客和服务商之间的事。要查看每个App画面,请看[顾客如何用DuitNow QR付款](/zh/duitnow-qr-payment-steps/#先买后付)。 ## 通过DuitNow QR或直接渠道 直接先买后付渠道是你结账页面上的一个独立渠道。下表列出两者的分别: | | 通过DuitNow QR | 直接先买后付渠道 | |---|---|---| | 设置 | 不需要设置,有DuitNow QR就能用。 | 先向Bayarcash申请。 | | 顾客在哪里选择分期计划 | 扫描后,在自己的App里 | 在你的结账页面 | | 你的手续费 | 只有DuitNow QR手续费。分期费用(如有)由顾客付给服务商。 | 先买后付手续费 | | 每笔付款的上限 | SPayLater:最高RM 1,000。Boost PayFlex:目前没有固定上限,但Boost可以更改。 | 更高,最高可达顾客的全部额度 | | 结账页面上的分期计划 | 不显示 | 显示 | 各渠道的手续费在[Payout计算器](/zh/payout-calculator/)页面。 ## 选择哪一种 通过DuitNow QR先买后付不会增加你的成本,也不需要设置。通过DuitNow QR时,SPayLater的上限是RM 1,000。金额更高时,顾客必须用其他方式付款。Boost PayFlex目前没有固定上限。服务商随时可以更改限额。 直接先买后付渠道适合金额较高的付款,也会在你的结账页面显示先买后付。你可以两者都用:保持DuitNow QR开启,当顾客购买较贵的商品时,再加上直接渠道。 ## 小贴士 - **不要向顾客承诺先买后付的额度**。通过DuitNow QR,SPayLater的上限是RM 1,000。服务商可以更改限额,而且每位顾客自己的额度可能更低。 - **告诉顾客可以在App里先买后付**。你的结账页面只显示DuitNow QR码。很多顾客不知道有这个选项。 ## 常见问题 ### 我的顾客有SPayLater,但扫描我的QR码时没有出现这个选项。为什么? 通过DuitNow QR付款时,SPayLater每笔付款的上限是RM 1,000。如果金额更高,或顾客自己的SPayLater额度更低,App就不会显示SPayLater选项。顾客可以改用电子钱包余额或银行账户付款。 ### 顾客通过DuitNow QR使用SPayLater时,我要付先买后付的手续费吗? 不用。你会以DuitNow QR付款收到全额,只付DuitNow QR的手续费。分期费用(如有)由顾客付给服务商。手续费请看Payout计算器 (/zh/payout-calculator/)。 --- # Static or dynamic DuitNow QR: what is the difference > Bayarcash uses dynamic DuitNow QR, one QR for each payment with the amount set. See how it differs from a printed static QR. > > Source: https://docs.bayarcash.com/duitnow-qr-static-dynamic/ Bayarcash uses **dynamic** DuitNow QR. Each payment gets its own QR, with the amount already in it, and the QR expires after about 5 minutes. A **static** QR is one fixed QR, often a printed sticker, and the customer types the amount. Bayarcash does not offer a static QR. ## What each one does Both types use the same DuitNow QR standard, so your customer can scan them with any banking app or e-wallet that supports DuitNow QR. The differences are in how the QR is made and used: | | Static QR | Dynamic QR (Bayarcash) | |---|---|---| | What it is | One QR for all payments | A new QR for each payment | | Amount | The customer types it | Already in the QR. The customer cannot change it. | | Where it comes from | Printed once, for example as a sticker at a counter | Made for each order: on the Bayarcash payment page, on your own page through the API, or in BCL QR Terminal | | Time limit | None | Expires after about 5 minutes | | Match a payment to an order | You match it by hand, from the amount and the time | Automatic: the QR holds the order | | Payment confirmation | You check your bank or e-wallet app | Bayarcash sends the result to your shop or system, and the payment shows in **Transactions** | | Risks | The customer types a wrong amount. Someone sticks a fake QR over yours. | Low. The amount and your shop name are set, and an old QR stops working. | | Refunds | A refund is a new payment back to the customer. DuitNow has no void. | The same | | Disputes | The customer contacts their bank or e-wallet, within 60 days | The same | | Typical use | Market stalls, donation boxes | Online checkout, invoices, payment links, counters with a screen | | On Bayarcash | Not offered | Yes | ## How your customer pays Your customer scans the QR with their banking app or e-wallet. The app shows your shop name and the amount. The customer confirms the payment, and the app shows a receipt. For the screens in each app, see [How your customer pays with DuitNow QR](/duitnow-qr-payment-steps/). If the QR expires before the customer pays, show a new QR. Do not ask the customer to pay to an old QR. ## Take QR payments at a counter Bayarcash has no printed QR for a counter. Use BCL QR Terminal instead. BCL is a Bayarcash product to sell without a website. QR Terminal turns a phone, tablet or laptop into a payment counter: 1. You type the amount. 2. QR Terminal shows a new DuitNow QR for that sale. 3. The customer scans it and pays. The payment goes through your Bayarcash account, so it shows in **Transactions** with your other payments. See [QR Terminal in the BCL Help Centre](https://docs.bcl.my/qr-terminal/). ## Fees and payouts The DuitNow QR fee is the same for each payment, online or at a counter. To see the fee and the amount that you receive, use the [payout calculator](/payout-calculator/). Payouts follow the normal [payout schedule](/payout-schedule/). ## Tips Two habits prevent most QR problems: - **Show the QR only when the customer is ready to pay.** The QR expires after about 5 minutes. - **Check Transactions before you make a new QR for an order that the customer says they paid.** This prevents a double payment. ## Common issues ### Can I print one Bayarcash QR for my shop counter? No. Bayarcash does not offer a static QR. For sales at a counter, use BCL QR Terminal. It makes a new Bayarcash DuitNow QR for each sale, on a phone, tablet or laptop. See QR Terminal in the BCL Help Centre (https://docs.bcl.my/qr-terminal/). ### My customer says that the QR expired. What do I do? Each QR is valid for a short time only, about 5 minutes. Start a new payment, or show a new QR for the same order. If the customer says that they already paid, check the payment in Transactions first, so that they do not pay two times. ### Can my customer change the amount after they scan the QR? No. The amount is in the QR. To charge a different amount, start a new payment. --- # DuitNow QR statik atau dinamik: apa bezanya > Bayarcash menggunakan DuitNow QR dinamik, iaitu satu QR untuk setiap bayaran dengan amaun yang sudah ditetapkan. Lihat bezanya dengan QR statik. > > Source: https://docs.bayarcash.com/ms/duitnow-qr-static-dynamic/ Bayarcash menggunakan DuitNow QR **dinamik**. Setiap bayaran ada QR sendiri, dengan amaun yang sudah ada di dalamnya, dan QR itu tamat tempoh selepas lebih kurang 5 minit. QR **statik** ialah satu QR tetap, selalunya sticker yang dicetak, dan pelanggan menaip amaun sendiri. Bayarcash tidak menawarkan QR statik. ## Beza kedua-dua jenis QR Kedua-dua jenis menggunakan standard DuitNow QR yang sama. Jadi pelanggan anda boleh scan kedua-duanya dengan mana-mana app perbankan atau e-wallet yang menyokong DuitNow QR. Bezanya ialah cara QR itu dibuat dan digunakan: | | QR statik | QR dinamik (Bayarcash) | |---|---|---| | Apa itu | Satu QR untuk semua bayaran | QR baru untuk setiap bayaran | | Amaun | Pelanggan menaipnya sendiri | Sudah ada dalam QR. Pelanggan tidak boleh menukarnya. | | Dari mana QR itu datang | Dicetak sekali, contohnya sebagai sticker di kaunter | Dibuat untuk setiap pesanan: di page bayaran Bayarcash, di page anda sendiri melalui API, atau dalam BCL QR Terminal | | Had masa | Tiada | Tamat tempoh selepas lebih kurang 5 minit | | Padankan bayaran dengan pesanan | Anda padankan sendiri, berdasarkan amaun dan masa | Automatik: QR itu menyimpan pesanan | | Pengesahan bayaran | Anda semak app bank atau e-wallet anda | Bayarcash menghantar keputusan ke kedai atau sistem anda, dan bayaran itu dipaparkan dalam **Transactions** | | Risiko | Pelanggan menaip amaun yang salah. Orang lain melekatkan QR palsu di atas QR anda. | Rendah. Amaun dan nama kedai anda sudah ditetapkan, dan QR lama tidak lagi berfungsi. | | Refund | Refund ialah bayaran baru kembali kepada pelanggan. DuitNow tiada void. | Sama | | Pertikaian | Pelanggan menghubungi bank atau e-wallet mereka, dalam tempoh 60 hari | Sama | | Kegunaan biasa | Gerai pasar, tabung derma | Checkout online, invois, payment link, kaunter yang ada skrin | | Dalam Bayarcash | Tidak ditawarkan | Ya | ## Cara pelanggan anda membayar Pelanggan anda scan QR itu dengan app perbankan atau e-wallet mereka. App itu memaparkan nama kedai anda dan amaun. Pelanggan mengesahkan bayaran, dan app itu memaparkan resit. Untuk skrin dalam setiap app, lihat [Cara pelanggan anda membayar dengan DuitNow QR](/ms/duitnow-qr-payment-steps/). Jika QR itu tamat tempoh sebelum pelanggan membayar, paparkan QR baru. Jangan minta pelanggan membayar ke QR yang lama. ## Terima bayaran QR di kaunter Bayarcash tiada QR bercetak untuk kaunter. Guna BCL QR Terminal sebagai ganti. BCL ialah produk Bayarcash untuk berniaga tanpa laman web. QR Terminal menjadikan telefon, tablet atau laptop sebagai kaunter bayaran: 1. Anda menaip amaun. 2. QR Terminal memaparkan DuitNow QR baru untuk jualan itu. 3. Pelanggan scan QR itu dan membayar. Bayaran itu melalui akaun Bayarcash anda, jadi bayaran itu dipaparkan dalam **Transactions** bersama bayaran anda yang lain. Lihat [Terima bayaran dengan QR Terminal](https://docs.bcl.my/ms/qr-terminal/) dalam Help Centre BCL. ## Caj dan payout Caj DuitNow QR sama untuk setiap bayaran, sama ada online atau di kaunter. Untuk melihat caj dan amaun yang anda terima, guna [kalkulator payout](/ms/payout-calculator/). Payout mengikut [jadual payout](/ms/payout-schedule/) yang biasa. ## Tips Dua habit ini mengelakkan kebanyakan masalah QR: - **Paparkan QR hanya apabila pelanggan sudah sedia untuk membayar.** QR itu tamat tempoh selepas lebih kurang 5 minit. - **Semak Transactions sebelum anda membuat QR baru untuk pesanan yang pelanggan kata sudah dibayar.** Dengan cara ini, pelanggan tidak membayar dua kali. ## Isu biasa ### Bolehkah saya cetak satu QR Bayarcash untuk kaunter kedai saya? Tidak boleh. Bayarcash tidak menawarkan QR statik. Untuk jualan di kaunter, guna BCL QR Terminal. QR Terminal membuat DuitNow QR Bayarcash yang baru untuk setiap jualan, pada telefon, tablet atau laptop. Lihat Terima bayaran dengan QR Terminal (https://docs.bcl.my/ms/qr-terminal/) dalam Help Centre BCL. ### Pelanggan saya kata QR itu sudah tamat tempoh. Apa yang saya perlu buat? Setiap QR hanya sah untuk masa yang singkat, lebih kurang 5 minit. Mulakan bayaran baru, atau paparkan QR baru untuk pesanan yang sama. Jika pelanggan kata mereka sudah bayar, semak bayaran itu dalam Transactions dahulu, supaya pelanggan tidak bayar dua kali. ### Bolehkah pelanggan saya menukar amaun selepas mereka scan QR? Tidak boleh. Amaun itu sudah ada dalam QR. Untuk caj amaun yang lain, mulakan bayaran baru. --- # 静态或动态DuitNow QR:有什么分别 > Bayarcash使用动态DuitNow QR,每笔付款一个QR码,金额已设定。看看它和印好的静态QR码有什么不同。 > > Source: https://docs.bayarcash.com/zh/duitnow-qr-static-dynamic/ Bayarcash使用**动态**DuitNow QR。每笔付款都有自己的QR码,金额已经在里面,而且QR码大约5分钟后就会过期。**静态**QR码是一个固定的QR码,通常是印好的贴纸,由顾客自己输入金额。Bayarcash不提供静态QR码。 ## 两种QR码的作用 两种都使用同样的DuitNow QR标准,所以顾客可以用任何支持DuitNow QR的银行App或电子钱包扫描。不同之处在于QR码的生成和使用方式: | | 静态QR码 | 动态QR码(Bayarcash) | |---|---|---| | 是什么 | 所有付款共用一个QR码 | 每笔付款一个新的QR码 | | 金额 | 顾客自己输入 | 已经在QR码里。顾客不能更改。 | | 来源 | 印一次,例如贴在柜台的贴纸 | 为每个订单生成:在Bayarcash付款页面、通过API在你自己的页面,或在BCL QR Terminal | | 时间限制 | 没有 | 大约5分钟后过期 | | 把付款对应到订单 | 你根据金额和时间手动对应 | 自动:QR码里有订单资料 | | 付款确认 | 你查看自己的银行或电子钱包App | Bayarcash把结果发送到你的商店或系统,付款也会显示在**Transactions**里 | | 风险 | 顾客输入错误金额。有人把假QR码贴在你的QR码上。 | 低。金额和你的商店名称已经设定,旧的QR码会失效。 | | 退款 | 退款是一笔转回给顾客的新付款。DuitNow没有void(作废)功能。 | 一样 | | 争议 | 顾客在60天内联系自己的银行或电子钱包 | 一样 | | 常见用途 | 市场摊位、捐款箱 | 网上结账、发票、付款链接、有屏幕的柜台 | | 在Bayarcash | 不提供 | 有 | ## 顾客如何付款 顾客用自己的银行App或电子钱包扫描QR码。App会显示你的商店名称和金额。顾客确认付款后,App会显示收据。每个App的画面,请看[顾客如何用DuitNow QR付款](/zh/duitnow-qr-payment-steps/)。 如果QR码在顾客付款前过期,请显示一个新的QR码。不要让顾客付款到旧的QR码。 ## 在柜台收QR付款 Bayarcash没有给柜台用的印刷QR码。请改用BCL QR Terminal。BCL是Bayarcash的产品,让你不用网站也能销售。QR Terminal把手机、平板电脑或手提电脑变成收款柜台: 1. 你输入金额。 2. QR Terminal为这笔销售显示一个新的DuitNow QR码。 3. 顾客扫描后付款。 这笔付款通过你的Bayarcash账号处理,所以它会和你的其他付款一起显示在**Transactions**里。请看BCL Help Centre里的[用QR Terminal收款](https://docs.bcl.my/zh/qr-terminal/)。 ## 手续费和payout DuitNow QR的手续费每笔付款都一样,不论是网上还是在柜台。如果要查看手续费和你收到的金额,请使用[Payout计算器](/zh/payout-calculator/)。Payout按照一般的[Payout结算时间表](/zh/payout-schedule/)进行。 ## 小贴士 两个习惯可以避免大部分QR码问题: - **顾客准备好付款时才显示QR码。** QR码大约5分钟后就会过期。 - **如果顾客说某个订单已经付款,先查看Transactions,再为这个订单生成新的QR码。** 这样可以避免重复付款。 ## 常见问题 ### 我可以为商店柜台打印一个Bayarcash QR码吗? 不可以。Bayarcash不提供静态QR码。柜台销售请使用BCL QR Terminal。它会在手机、平板电脑或手提电脑上,为每笔销售生成一个新的Bayarcash DuitNow QR码。请看BCL Help Centre里的用QR Terminal收款 (https://docs.bcl.my/zh/qr-terminal/)。 ### 顾客说QR码已经过期。我该怎么做? 每个QR码只在很短的时间内有效,大约5分钟。请发起一笔新付款,或为同一个订单显示新的QR码。如果顾客说他们已经付款,请先在Transactions里查看这笔付款,以免他们付两次。 ### 顾客扫描QR码后可以更改金额吗? 不可以。金额已经在QR码里。如果要收不同的金额,请发起一笔新付款。 --- # Accept payments from abroad with cross-border channels > Switch on QRIS Indonesia, NETS Singapore and the other cross-border channels for a portal so overseas customers can pay you in Malaysia. > > Source: https://docs.bayarcash.com/cross-border-channels/ Cross-border channels let customers in Indonesia, Singapore and other countries pay from their own banking app or e-wallet. You switch them on per portal in the merchant dashboard. Then you show them on your form or checkout. ## The cross-border channels Each channel has an ID that developers use as `payment_channel` in the API. | ID | Channel | Customers from | |---|---|---| | 9 | QRIS Indonesia (online banking) | Indonesia | | 10 | QRIS Indonesia (e-wallet) | Indonesia | | 11 | NETS | Singapore | | 13 | Alipay | China | | 14 | WeChat Pay | China | | 15 | PromptPay | Thailand | ## Switch the channels on for a portal Do this in the merchant dashboard when you create a portal for overseas payments. 1. Sign in to the merchant dashboard and open **Portals**. 2. Click **Add New Portal**. 3. To use every channel, tick all of them. 4. To serve only one country, tick only the **DuitNow QR QRIS Indonesia** channels or **DuitNow QR NETS Singapore**. 5. Save the portal. *(Screenshot: The Cross Border QR Payment channels with NETS Singapore and the two QRIS Indonesia channels ticked)* If a channel is not in the list, ask the Bayarcash team to switch it on for your account. ## Show the channels where customers pay Bayarcash switches the channel on. Your form or shop must then offer it. 1. Connect the portal key of that portal to your form or shop. See [Portals](/portals/). 2. In BCL (bcl.my), open the form's payment options and add the channel, then update the form. The steps are in the BCL help centre: [NETS for Singapore customers](https://docs.bcl.my/nets-singapore/). 3. For plugins and the API, pick the channel in the plugin, or send its ID as `payment_channel`. See the [API reference](https://api-reference.bayarcash.com). Payments then show under **Transactions**. See [Transactions](/transactions/). ## Banks and e-wallets that work Customers pay with the app of their own bank or e-wallet. These banks and e-wallets support payments to Malaysia. Other apps can also work. | Country | Banks and e-wallets | |---|---| | Thailand | Bangkok Bank, Bank of Ayudhya, CIMB Thai, Krungthai Bank, Siam Commercial Bank | | Indonesia | Bank Central Asia (BCA), Bank Syariah Indonesia (BSI), BPD Bali, CIMB Niaga, DANA, LinkAja, Mega, OttoCash, Permata, ShopeePay, Sinarmas | | Singapore | DBS, OCBC, United Overseas Bank (UOB) | ## Pay from Indonesia with QRIS Customers in Indonesia pay with QRIS, the national QR code standard of Indonesia. This is what an Indonesian customer sees in a banking app, in this example Livin' by Mandiri: 1. They scan your DuitNow QR code. The app shows your shop name, the amount in MYR and their source of funds. They tap **Next**. 2. On **Transaction Confirmation**, they check the rate from MYR to IDR and the amount in rupiah. They tap **Continue Payment**. 3. The app shows **Payment Successful!**. *(Screenshot: Livin' by Mandiri: the amount in MYR, the Transaction Confirmation with the MYR to IDR rate, and the Payment Successful! screen)* The account number, balance and merchant number in the picture are samples. ## Pay from Singapore with DBS PayLah! Customers in Singapore can pay you with DBS PayLah!, the payment app of DBS Bank, through DuitNow QR. 1. In DBS PayLah!, the customer taps **Scan** and scans your DuitNow QR code. 2. On **Pay**, they check your shop name, the amount in MYR and the same amount in SGD. They tap **NEXT**. 3. The app shows **Successful**. It also shows the exchange rate and the amount in SGD that DBS takes from their account. *(Screenshot: DBS PayLah!: the Scan button, the Pay screen with MYR 5.00 and SGD 1.50, and the Successful screen)* ## Common issues ### The QRIS or NETS option is not in my form or checkout. What should I check? The channel must be switched on for the portal your shop or form uses. Open the portal in the merchant dashboard, or ask the Bayarcash team, then refresh the portal list where you use it. ### Do I need a separate portal for Singapore or Indonesia? No. You can tick all channels on one portal, or only QRIS Indonesia or NETS Singapore if you serve one country. --- # Terima bayaran dari luar negara dengan saluran cross-border > On-kan QRIS Indonesia, NETS Singapore dan saluran cross-border lain untuk portal, supaya pelanggan luar negara boleh membayar anda di Malaysia. > > Source: https://docs.bayarcash.com/ms/cross-border-channels/ Dengan saluran cross-border, pelanggan di Indonesia, Singapura dan negara lain boleh membayar dari aplikasi perbankan atau e-wallet mereka sendiri. Anda on-kan saluran ini untuk setiap portal dalam merchant dashboard. Kemudian anda paparkan saluran itu pada form atau checkout anda. ## Saluran cross-border Setiap saluran ada ID yang developer guna sebagai `payment_channel` dalam API. | ID | Saluran | Pelanggan dari | |---|---|---| | 9 | QRIS Indonesia (online banking) | Indonesia | | 10 | QRIS Indonesia (e-wallet) | Indonesia | | 11 | NETS | Singapura | | 13 | Alipay | China | | 14 | WeChat Pay | China | | 15 | PromptPay | Thailand | ## On-kan saluran untuk portal Buat langkah ini dalam merchant dashboard semasa anda membuat portal untuk bayaran dari luar negara. 1. Log masuk ke merchant dashboard dan buka **Portals**. 2. Klik **Add New Portal**. 3. Untuk menggunakan semua saluran, tandakan semuanya. 4. Untuk pelanggan dari satu negara sahaja, tandakan saluran **DuitNow QR QRIS Indonesia** sahaja, atau **DuitNow QR NETS Singapore** sahaja. 5. Simpan portal itu. *(Screenshot: Saluran Cross Border QR Payment, dengan NETS Singapore dan dua saluran QRIS Indonesia ditandakan)* Jika sesuatu saluran tiada dalam senarai, minta Bayarcash on-kan saluran itu untuk akaun anda. ## Paparkan saluran di tempat pelanggan membayar Selepas Bayarcash on-kan saluran itu, form atau kedai anda mesti menawarkannya kepada pelanggan. 1. Sambungkan portal key bagi portal itu ke form atau kedai anda. Lihat [Portal](/ms/portals/). 2. Dalam BCL (bcl.my), buka pilihan bayaran form itu dan tambah saluran itu, kemudian update form. Langkahnya ada dalam Help Centre BCL: [NETS untuk pelanggan Singapura](https://docs.bcl.my/ms/nets-singapore/). 3. Untuk plugin dan API, pilih saluran itu dalam plugin, atau hantar ID-nya sebagai `payment_channel`. Lihat [API reference](https://api-reference.bayarcash.com). Bayaran itu kemudian dipaparkan di bawah **Transactions**. Lihat [Semak transaksi dan statusnya](/ms/transactions/). ## Bank & e-wallet yang boleh digunakan Pelanggan membayar dengan app bank atau e-wallet mereka sendiri. Bank dan e-wallet ini menyokong bayaran ke Malaysia. App lain juga mungkin boleh digunakan. | Negara | Bank dan e-wallet | |---|---| | Thailand | Bangkok Bank, Bank of Ayudhya, CIMB Thai, Krungthai Bank, Siam Commercial Bank | | Indonesia | Bank Central Asia (BCA), Bank Syariah Indonesia (BSI), BPD Bali, CIMB Niaga, DANA, LinkAja, Mega, OttoCash, Permata, ShopeePay, Sinarmas | | Singapura | DBS, OCBC, United Overseas Bank (UOB) | ## Bayar dari Indonesia dengan QRIS Pelanggan di Indonesia membayar dengan QRIS, iaitu standard kod QR kebangsaan Indonesia. Ini yang pelanggan Indonesia nampak dalam app perbankan. Contoh ini menggunakan Livin' by Mandiri: 1. Pelanggan scan kod DuitNow QR anda. App itu memaparkan nama kedai anda, amaun dalam MYR dan sumber dana pelanggan. Pelanggan klik **Next**. 2. Pada **Transaction Confirmation**, pelanggan menyemak rate MYR ke IDR dan amaun dalam rupiah. Pelanggan klik **Continue Payment**. 3. App itu memaparkan **Payment Successful!**. *(Screenshot: Livin' by Mandiri: amaun dalam MYR, Transaction Confirmation dengan rate MYR ke IDR, dan skrin Payment Successful!)* Nombor akaun, baki dan nombor merchant dalam gambar ialah contoh sahaja. ## Bayar dari Singapura dengan DBS PayLah! Pelanggan di Singapura boleh membayar anda dengan DBS PayLah!, iaitu app bayaran DBS Bank, melalui DuitNow QR. 1. Dalam DBS PayLah!, pelanggan klik **Scan** dan scan kod DuitNow QR anda. 2. Pada **Pay**, pelanggan menyemak nama kedai anda, amaun dalam MYR dan amaun yang sama dalam SGD. Pelanggan klik **NEXT**. 3. App itu memaparkan **Successful**. App itu juga memaparkan exchange rate dan amaun dalam SGD yang DBS tolak dari akaun pelanggan. *(Screenshot: DBS PayLah!: butang Scan, skrin Pay dengan MYR 5.00 dan SGD 1.50, dan skrin Successful)* ## Isu biasa ### Kenapa QRIS atau NETS tidak dipaparkan dalam form atau checkout saya? Saluran itu mesti di-on-kan untuk portal yang digunakan oleh kedai atau form anda. Buka portal itu dalam merchant dashboard, atau minta Bayarcash on-kan saluran itu. Kemudian refresh senarai portal di tempat anda menggunakannya. ### Adakah saya perlu portal yang berasingan untuk Singapura atau Indonesia? Tidak perlu. Anda boleh tandakan semua saluran pada satu portal. Jika pelanggan anda dari satu negara sahaja, tandakan QRIS Indonesia atau NETS Singapore sahaja. --- # 用跨境渠道接受海外付款 > 为portal开启QRIS Indonesia、NETS Singapore和其他跨境渠道,让海外顾客付款给你在马来西亚的商店。 > > Source: https://docs.bayarcash.com/zh/cross-border-channels/ 跨境渠道让印尼、新加坡和其他国家的顾客,用他们自己的银行App或电子钱包付款。你在商家后台(merchant dashboard)为每个portal开启这些渠道,然后在你的表单或结账页面显示它们。 ## 跨境渠道 每个渠道都有一个ID,开发者在API里把它用作`payment_channel`。 | ID | 渠道 | 顾客来自 | |---|---|---| | 9 | QRIS Indonesia (online banking) | 印尼 | | 10 | QRIS Indonesia (e-wallet) | 印尼 | | 11 | NETS | 新加坡 | | 13 | Alipay | 中国 | | 14 | WeChat Pay | 中国 | | 15 | PromptPay | 泰国 | ## 为portal开启渠道 当你为海外付款创建portal时,在商家后台进行以下步骤。 1. 登录商家后台,然后打开**Portals**。 2. 点击**Add New Portal**。 3. 如果要使用每个渠道,全部勾选。 4. 如果只服务一个国家,只勾选**DuitNow QR QRIS Indonesia**渠道或**DuitNow QR NETS Singapore**。 5. 保存portal。 *(Screenshot: Cross Border QR Payment渠道,已勾选NETS Singapore和两个QRIS Indonesia渠道)* 如果列表里没有某个渠道,请Bayarcash团队为你的账号开启。 ## 在顾客付款的地方显示渠道 Bayarcash开启渠道后,你的表单或商店还必须提供这个渠道。 1. 把该portal的portal key连接到你的表单或商店。请看[Portal](/zh/portals/)。 2. 在BCL(bcl.my)里,打开表单的付款选项,加入这个渠道,然后更新表单。步骤在BCL Help Centre里:[用NETS接受来自新加坡的付款](https://docs.bcl.my/zh/nets-singapore/)。 3. 如果用插件或API,在插件里选择这个渠道,或把它的ID作为`payment_channel`发送。请看[API reference](https://api-reference.bayarcash.com)。 付款之后会显示在**Transactions**下。请看[查看交易和交易状态](/zh/transactions/)。 ## 可以使用的银行和电子钱包 顾客用自己银行或电子钱包的App付款。以下银行和电子钱包支持付款到马来西亚。其他App也可能可以使用。 | 国家 | 银行和电子钱包 | |---|---| | 泰国 | Bangkok Bank, Bank of Ayudhya, CIMB Thai, Krungthai Bank, Siam Commercial Bank | | 印尼 | Bank Central Asia (BCA), Bank Syariah Indonesia (BSI), BPD Bali, CIMB Niaga, DANA, LinkAja, Mega, OttoCash, Permata, ShopeePay, Sinarmas | | 新加坡 | DBS, OCBC, United Overseas Bank (UOB) | ## 用QRIS从印尼付款 印尼的顾客用QRIS付款。QRIS是印尼的国家QR码标准。 这是印尼顾客在银行App里看到的画面,这个例子是Livin' by Mandiri: 1. 他们扫描你的DuitNow QR码。App显示你的商店名称、MYR金额和他们的资金来源。他们点击**Next**。 2. 在**Transaction Confirmation**画面,他们检查MYR兑IDR的汇率和印尼盾金额。他们点击**Continue Payment**。 3. App显示**Payment Successful!**。 *(Screenshot: Livin' by Mandiri:MYR金额、显示MYR兑IDR汇率的Transaction Confirmation,以及Payment Successful!画面)* 图片里的账户号码、余额和商家号码都是示例。 ## 用DBS PayLah!从新加坡付款 新加坡的顾客可以用DBS PayLah!(DBS Bank的付款App),通过DuitNow QR付款给你。 1. 在DBS PayLah!里,顾客点击**Scan**,然后扫描你的DuitNow QR码。 2. 在**Pay**画面,他们检查你的商店名称、MYR金额和同等的SGD金额。他们点击**NEXT**。 3. App显示**Successful**。它也会显示汇率,以及DBS从他们账户扣除的SGD金额。 *(Screenshot: DBS PayLah!:Scan按钮、显示MYR 5.00和SGD 1.50的Pay画面,以及Successful画面)* ## 常见问题 ### 我的表单或结账页面没有QRIS或NETS选项。我要检查什么? 你的商店或表单使用的portal必须开启这个渠道。在商家后台打开这个portal,或请Bayarcash团队开启,然后在你使用portal的地方刷新portal列表。 ### 新加坡或印尼需要另外的portal吗? 不需要。你可以在一个portal勾选所有渠道。如果你只服务一个国家,也可以只勾选QRIS Indonesia或NETS Singapore。 --- # FPX Line of Credit (credit card account payments) > What FPX Line of Credit is, how customers pay with a bank credit card account through FPX, and what your portal needs. > > Source: https://docs.bayarcash.com/fpx-line-of-credit/ FPX Line of Credit lets a customer pay from a credit facility their own bank gives them, through FPX. It is also called a Credit Card Account (CCA). The customer stays inside their bank's secure page, so they never enter a card number on your site. ## How the customer pays This is what your customer sees at checkout. 1. They choose the FPX Line of Credit option (some shops label it Credit Card). 2. They choose their bank and the account type, CASA or CCA. 3. They sign in to their bank and approve the payment. At their bank, the customer chooses where the money comes from. With a current or savings account (CASA), the list shows only their bank accounts: *(Screenshot: A Maybank2u FPX page with the From account list open. The list has only bank accounts (CASA))* With FPX Line of Credit (CCA), the same list also shows their credit cards: *(Screenshot: A Maybank2u FPX page with the From account list open. The list has bank accounts and two credit cards (CCA))* The money is charged to their credit account. Their bank sends them a monthly statement, and the bank decides the credit limit and any charges. Your payment still goes through Bayarcash as normal. ## Set it up You need the channel switched on for your portal. 1. Ask the Bayarcash team to switch on **FPX Line of Credit** for your portal, or tick it when you create a portal with **Add New Portal** under **Portals**. 2. Show the channel in your shop or form. In the WooCommerce plugin it is the **Bayarcash Credit Card Account** method. Developers use `payment_channel` 4 in the [API](https://api-reference.bayarcash.com). *(Screenshot: The FPX group on the Add New Portal form with FPX Line of Credit ticked and highlighted)* ## Good to know - **Malaysian banks only.** Customers can choose only local banks. - **Failures come from the bank.** If a payment fails, see [Why did my payment fail?](/payment-failed/). - **Payments appear in Transactions.** See [Transactions](/transactions/). ## Common issues ### Is FPX Line of Credit the same as accepting credit cards? Not exactly. The customer pays from their bank credit facility through FPX, so they never type a card number. The Credit Card channel is a separate channel. See Payment channels (/payment-channels/). ### Can overseas customers pay with FPX Line of Credit? No. It supports Malaysian banks only. ### The option is missing at checkout. What should I do? Check that FPX Line of Credit is switched on for the portal you use. If not, ask the Bayarcash team, then try again. --- # FPX Line of Credit (bayaran dengan akaun kad kredit) > Apa itu FPX Line of Credit, cara pelanggan membayar dengan akaun kad kredit bank melalui FPX, dan apa yang portal anda perlukan. > > Source: https://docs.bayarcash.com/ms/fpx-line-of-credit/ Dengan FPX Line of Credit, pelanggan membayar melalui FPX daripada kemudahan kredit yang bank mereka sendiri berikan. Nama lainnya ialah Credit Card Account (CCA). Pelanggan kekal di page selamat bank mereka, jadi mereka tidak memasukkan nombor kad di laman web anda. ## Cara pelanggan membayar Ini yang pelanggan anda nampak semasa checkout: 1. Pelanggan memilih FPX Line of Credit. Sesetengah kedai melabelkannya sebagai Credit Card. 2. Pelanggan memilih bank dan jenis akaun, iaitu CASA atau CCA. 3. Pelanggan log masuk ke bank mereka dan meluluskan bayaran itu. Di page bank, pelanggan memilih akaun untuk membayar. Untuk akaun semasa atau akaun simpanan (CASA), senarai itu hanya memaparkan akaun bank pelanggan: *(Screenshot: Page FPX Maybank2u dengan senarai akaun From terbuka. Senarai itu hanya ada akaun bank (CASA))* Untuk FPX Line of Credit (CCA), senarai yang sama juga memaparkan kad kredit pelanggan: *(Screenshot: Page FPX Maybank2u dengan senarai akaun From terbuka. Senarai itu ada akaun bank dan dua kad kredit (CCA))* Bayaran itu dicaj ke akaun kredit pelanggan. Bank menghantar penyata bulanan kepada pelanggan. Bank juga yang menentukan had kredit dan sebarang caj. Bayaran anda tetap melalui Bayarcash seperti biasa. ## Sediakan saluran ini Saluran ini mesti di-on-kan untuk portal anda. 1. Minta Bayarcash on-kan **FPX Line of Credit** untuk portal anda. Atau tandakan saluran itu semasa anda membuat portal dengan **Add New Portal** di bawah **Portals**. 2. Paparkan saluran itu dalam kedai atau form anda. Dalam plugin WooCommerce, saluran ini ialah kaedah **Bayarcash Credit Card Account**. Developer guna `payment_channel` 4 dalam [API](https://api-reference.bayarcash.com). *(Screenshot: Kumpulan FPX dalam form Add New Portal, dengan FPX Line of Credit ditandakan dan diserlahkan)* ## Perkara yang perlu anda tahu Tiga perkara tentang saluran ini: - **Bank Malaysia sahaja.** Pelanggan hanya boleh memilih bank tempatan. - **Bayaran yang gagal berpunca daripada bank.** Jika sesuatu bayaran gagal, lihat [Kenapa bayaran saya gagal?](/ms/payment-failed/). - **Bayaran dipaparkan dalam Transactions.** Lihat [Semak transaksi dan statusnya](/ms/transactions/). ## Isu biasa ### Adakah FPX Line of Credit sama dengan menerima kad kredit? Tidak sama. Pelanggan membayar daripada kemudahan kredit bank mereka melalui FPX, jadi mereka tidak perlu menaip nombor kad. Credit Card ialah saluran yang lain. Lihat Saluran bayaran (/ms/payment-channels/). ### Boleh pelanggan luar negara membayar dengan FPX Line of Credit? Tidak boleh. Saluran ini hanya menyokong bank Malaysia. ### Kenapa pilihan FPX Line of Credit tiada semasa checkout? Pastikan FPX Line of Credit di-on-kan untuk portal yang anda guna. Jika belum, minta Bayarcash on-kan saluran itu, kemudian cuba semula. --- # FPX Line of Credit(用信用卡账户付款) > 什么是FPX Line of Credit,顾客如何通过FPX用银行信用卡账户付款,以及你的portal需要什么。 > > Source: https://docs.bayarcash.com/zh/fpx-line-of-credit/ FPX Line of Credit让顾客通过FPX,从自己银行给的信贷额度付款。它也叫Credit Card Account(CCA)。顾客一直在自己银行的安全页面里,所以他们不需要在你的网站输入卡号。 ## 顾客如何付款 这是顾客在结账时看到的步骤。 1. 他们选择FPX Line of Credit选项(有些商店把它标为Credit Card)。 2. 他们选择自己的银行和账户类型:CASA或CCA。 3. 他们登录自己的银行,然后批准付款。 在银行页面,顾客选择用哪个账户付款。如果用往来或储蓄账户(CASA),列表只显示他们的银行账户: *(Screenshot: Maybank2u的FPX页面,From账户列表已打开。列表只有银行账户(CASA))* 如果用FPX Line of Credit(CCA),同一个列表也会显示他们的信用卡: *(Screenshot: Maybank2u的FPX页面,From账户列表已打开。列表有银行账户和两张信用卡(CCA))* 款项会从他们的信用账户扣除。他们的银行每月寄账单给他们,信用额度和任何手续费都由银行决定。你的付款照常通过Bayarcash处理。 ## 设置 你需要为portal开启这个渠道。 1. 请Bayarcash团队为你的portal开启**FPX Line of Credit**,或者在**Portals**下用**Add New Portal**创建portal时勾选它。 2. 在你的商店或表单显示这个渠道。在WooCommerce插件里,它是**Bayarcash Credit Card Account**付款方式。开发者在[API](https://api-reference.bayarcash.com)里使用`payment_channel` 4。 *(Screenshot: Add New Portal表单上的FPX组别,FPX Line of Credit已勾选并已标示)* ## 须知 - **只限马来西亚的银行。** 顾客只能选择本地银行。 - **付款失败来自银行。** 如果付款失败,请看[为什么我的付款失败?](/zh/payment-failed/)。 - **付款会显示在Transactions里。** 请看[查看交易和交易状态](/zh/transactions/)。 ## 常见问题 ### FPX Line of Credit等于接受信用卡吗? 不完全一样。顾客通过FPX,从银行给他们的信贷额度付款,所以他们不需要输入卡号。Credit Card渠道是另一个渠道。请看付款渠道 (/zh/payment-channels/)。 ### 海外顾客可以用FPX Line of Credit付款吗? 不可以。它只支持马来西亚的银行。 ### 结账时没有这个选项。我该怎么做? 检查你使用的portal是否已开启FPX Line of Credit。如果没有,请联系Bayarcash团队,然后再试一次。 --- # Check a transaction and its status > Find a payment in the merchant dashboard, read its status, open the transaction details and see your totals for each status. > > Source: https://docs.bayarcash.com/transactions/ Use **Transactions** in the merchant dashboard to find a customer's payment, see if it succeeded and read its details. This helps you answer "did my customer pay?" quickly. ## Find a transaction You need to be signed in to the merchant dashboard. 1. Open **Transactions**. 2. Use the filters to narrow the list. You can filter by the same information you see in the transaction details, such as the order number. 3. Read the status column for each payment. *(Screenshot: The Transactions page with the Advance Filter button and the eye icon highlighted)* ## See the transactions of one portal Each website or app that takes payments has its own portal. To see only the payments of one portal: 1. Open **Transactions**. 2. Click **Advance Filter**. 3. In **Portal**, choose the portal. **Any** shows the payments of all your portals. 4. Click **Filter**. *(Screenshot: The Advance Filter panel on the Transactions page with the Portal list and the Filter button highlighted)* To see all your portals again, click **Reset**. To find a portal's name, see [Portals](/portals/). ## Transaction statuses The status tells you where a payment stands. | Status | Code in the API | What it means | |---|---|---| | New | 0 | The payment has just started. | | Pending | 1 | The payment is in progress. Check again shortly. | | Unsuccessful | 2 | The payment did not go through, for example a bank decline or a problem in the process. | | Successful | 3 | The customer paid. | | Cancelled | 4 | The customer cancelled the payment. | | Abandoned | 5 | The customer left without finishing. | Developers can read the same codes from the [API reference](https://api-reference.bayarcash.com). ## Open the transaction details Do this to see the answer from FPX or the bank. 1. In **Transactions**, find the payment. 2. Click the eye icon (**View transaction details**). 3. Read the **Transaction Details** window. It shows the status message FPX or the bank sent. *(Screenshot: The Transaction Details window of an unsuccessful payment with the Status Description row highlighted)* If a payment failed, see [Why did my payment fail?](/payment-failed/). ## See your totals for each status The top of the **Transactions** page has a box for each status: **New**, **Pending**, **Unsuccessful**, **Successful**, **Cancelled** and **Abandoned**. Each box shows the number of transactions and the time of the last one. *(Screenshot: The status boxes at the top of the Transactions page)* To keep a copy of the list, see [Export transactions](/export-transactions/). Direct Debit collections are listed separately. See [Direct Debit transactions](/direct-debit-transactions/). ## Common issues ### My customer paid but the order is not marked as paid. What do I check? Open the transaction in Transactions and read its status. If it is Successful, Bayarcash has the payment and your shop or callback needs checking. See Callbacks and checksum (/callbacks-and-checksum/). If it is Pending, wait and check again. ### What is the difference between Cancelled and Abandoned? Cancelled means the customer cancelled the payment. Abandoned means they left without finishing. See the status table on this page. ### Where do I see why a payment failed? Open the transaction details with the eye icon. The response from FPX or the bank is shown there. See Why did my payment fail? (/payment-failed/). --- # Semak transaksi dan statusnya > Cari bayaran dalam merchant dashboard, baca statusnya, buka butiran transaksi dan lihat jumlah transaksi bagi setiap status. > > Source: https://docs.bayarcash.com/ms/transactions/ Guna **Transactions** dalam merchant dashboard untuk mencari bayaran pelanggan, melihat sama ada bayaran itu berjaya dan membaca butirannya. Dengan cara ini, anda boleh cepat menjawab soalan "pelanggan saya sudah bayar atau belum?" ## Cari transaksi Anda perlu log masuk ke merchant dashboard dahulu. 1. Buka **Transactions**. 2. Guna filter untuk mengecilkan senarai. Anda boleh filter mengikut maklumat yang sama seperti dalam butiran transaksi, contohnya nombor pesanan. 3. Baca lajur status bagi setiap bayaran. *(Screenshot: Page Transactions dengan butang Advance Filter dan ikon mata ditanda)* ## Lihat transaksi bagi satu portal Setiap laman web atau app yang menerima bayaran ada portal sendiri. Untuk melihat bayaran bagi satu portal sahaja: 1. Buka **Transactions**. 2. Klik **Advance Filter**. 3. Dalam **Portal**, pilih portal itu. **Any** memaparkan bayaran bagi semua portal anda. 4. Klik **Filter**. *(Screenshot: Panel Advance Filter pada page Transactions dengan senarai Portal dan butang Filter ditanda)* Untuk melihat semua portal anda semula, klik **Reset**. Untuk mencari nama portal, lihat [Tambah & guna portal](/ms/portals/). ## Status transaksi Status menunjukkan tahap sesuatu bayaran. | Status | Kod dalam API | Maksud | |---|---|---| | New | 0 | Bayaran baru bermula. | | Pending | 1 | Bayaran sedang diproses. Semak semula sebentar lagi. | | Unsuccessful | 2 | Bayaran tidak berjaya, contohnya bank menolaknya atau ada masalah dalam proses. | | Successful | 3 | Pelanggan sudah membayar. | | Cancelled | 4 | Pelanggan membatalkan bayaran itu. | | Abandoned | 5 | Pelanggan keluar sebelum bayaran selesai. | Developer boleh membaca kod yang sama dalam [API reference](https://api-reference.bayarcash.com). ## Buka butiran transaksi Buat langkah ini untuk melihat jawapan daripada FPX atau bank. 1. Dalam **Transactions**, cari bayaran itu. 2. Klik ikon mata (**View transaction details**). 3. Baca tetingkap **Transaction Details**. Tetingkap ini memaparkan mesej status yang dihantar oleh FPX atau bank. *(Screenshot: Tetingkap Transaction Details bagi bayaran yang tidak berjaya, dengan baris Status Description ditanda)* Jika sesuatu bayaran gagal, lihat [Kenapa bayaran saya gagal?](/ms/payment-failed/). ## Lihat jumlah bagi setiap status Bahagian atas page **Transactions** ada satu kotak untuk setiap status: **New**, **Pending**, **Unsuccessful**, **Successful**, **Cancelled** dan **Abandoned**. Setiap kotak memaparkan bilangan transaksi dan masa transaksi yang terakhir. *(Screenshot: Kotak status di bahagian atas page Transactions)* Untuk menyimpan salinan senarai ini, lihat [Export transaksi anda ke Excel](/ms/export-transactions/). Kutipan Direct Debit disenaraikan secara berasingan. Lihat [Transaksi Direct Debit](/ms/direct-debit-transactions/). ## Isu biasa ### Kenapa pesanan saya belum bertanda paid walaupun pelanggan sudah membayar? Buka transaksi itu dalam Transactions dan baca statusnya. Jika statusnya Successful, Bayarcash sudah menerima bayaran itu, jadi semak kedai atau callback anda. Lihat Callback dan checksum (/ms/callbacks-and-checksum/). Jika statusnya Pending, tunggu sebentar dan semak semula. ### Apakah beza antara Cancelled dan Abandoned? Cancelled bermaksud pelanggan membatalkan bayaran itu. Abandoned bermaksud pelanggan keluar sebelum bayaran selesai. Lihat jadual status dalam page ini. ### Di mana saya boleh lihat sebab sesuatu bayaran gagal? Buka butiran transaksi dengan ikon mata. Respons daripada FPX atau bank dipaparkan di situ. Lihat Kenapa bayaran saya gagal? (/ms/payment-failed/). --- # 查看交易和交易状态 > 在商家后台找到一笔付款,查看它的状态,打开交易详情,并查看每个状态的总数。 > > Source: https://docs.bayarcash.com/zh/transactions/ 在商家后台(merchant dashboard)使用**Transactions**,找到顾客的付款,查看付款是否成功,并阅读付款详情。这样你可以很快回答“我的顾客付款了吗?” ## 找到一笔交易 你需要先登录商家后台。 1. 打开**Transactions**。 2. 使用筛选功能缩小列表。你可以用交易详情里的同样资料来筛选,例如订单号码。 3. 查看每笔付款的状态列。 *(Screenshot: Transactions页面,已标示Advance Filter按钮和眼睛图标)* ## 查看一个portal的交易 每个收款的网站或App都有自己的portal。如果只要查看一个portal的付款: 1. 打开**Transactions**。 2. 点击**Advance Filter**。 3. 在**Portal**里选择该portal。**Any**会显示你所有portal的付款。 4. 点击**Filter**。 *(Screenshot: Transactions页面上的Advance Filter面板,已标示Portal列表和Filter按钮)* 如果要再次查看你所有的portal,点击**Reset**。如果要找portal的名称,请看[Portal](/zh/portals/)。 ## 交易状态 状态告诉你一笔付款目前的进度。 | 状态 | API里的代码 | 意思 | |---|---|---| | New | 0 | 付款刚刚开始。 | | Pending | 1 | 付款正在处理中。请稍后再查看。 | | Unsuccessful | 2 | 付款没有成功,例如银行拒绝或过程中出现问题。 | | Successful | 3 | 顾客已经付款。 | | Cancelled | 4 | 顾客取消了付款。 | | Abandoned | 5 | 顾客没有完成付款就离开了。 | 开发者可以在[API reference](https://api-reference.bayarcash.com)里查看同样的代码。 ## 打开交易详情 用这个方法查看FPX或银行的回复。 1. 在**Transactions**里找到这笔付款。 2. 点击眼睛图标(**View transaction details**)。 3. 阅读**Transaction Details**窗口。窗口会显示FPX或银行发来的状态信息。 *(Screenshot: 一笔不成功付款的Transaction Details窗口,已标示Status Description行)* 如果付款失败,请看[为什么我的付款失败?](/zh/payment-failed/)。 ## 查看每个状态的总数 **Transactions**页面顶部有每个状态的框:**New**、**Pending**、**Unsuccessful**、**Successful**、**Cancelled**和**Abandoned**。每个框显示交易数量和最后一笔交易的时间。 *(Screenshot: Transactions页面顶部的状态框)* 如果要保存这个列表,请看[把交易导出到Excel](/zh/export-transactions/)。Direct Debit的收款另外列出。请看[Direct Debit交易](/zh/direct-debit-transactions/)。 ## 常见问题 ### 顾客已经付款,但订单还没标为已付。我要检查什么? 在Transactions里打开这笔交易,查看它的状态。如果状态是Successful,Bayarcash已经收到这笔付款,你需要检查你的商店或callback。请看Callback和checksum (/zh/callbacks-and-checksum/)。如果状态是Pending,请稍等,然后再查看一次。 ### Cancelled和Abandoned有什么分别? Cancelled表示顾客取消了付款。Abandoned表示顾客没有完成付款就离开了。请看本页的状态表。 ### 我在哪里可以看到付款失败的原因? 点击眼睛图标,打开交易详情。FPX或银行的response会显示在那里。请看为什么我的付款失败? (/zh/payment-failed/)。 --- # Export your transactions to Excel > Download your Bayarcash transactions as an Excel file from the merchant dashboard, and what to do while a large export is processing. > > Source: https://docs.bayarcash.com/export-transactions/ You can download all your transactions as an Excel file for accounting or reconciliation. It is done from the **Transactions** page in the merchant dashboard. ## Export to Excel You need to be signed in to the merchant dashboard. 1. Open **Transactions**. 2. Click **Export Excel**, at the top left of the page. 3. In the pop-up, type a file name. 4. Confirm. The **Tools** page opens and shows your export. 5. When the export is marked as completed, download the file. *(Screenshot: The Transactions page with the Export Excel button highlighted)* *(Screenshot: The Excel Exports page with a completed export and its download button highlighted)* > **Note** > A large export can take about 5 minutes to complete. Leave the page and come back later if you need to. ## Other exports Exports for other parts of the merchant dashboard are in [Export module data](/export-module-data/). To look at one payment, see [Transactions](/transactions/). ## Common issues ### My export is still not ready. How long does it take? A large export can take about 5 minutes. Wait, then check the Tools page again. ### Where do I find the file after I click Export Excel? The merchant dashboard opens the Tools page. When the export is marked as completed, download it from there. --- # Export transaksi anda ke Excel > Muat turun transaksi Bayarcash anda sebagai fail Excel dari merchant dashboard, dan apa yang perlu dibuat semasa export yang besar diproses. > > Source: https://docs.bayarcash.com/ms/export-transactions/ Anda boleh muat turun semua transaksi anda sebagai fail Excel untuk perakaunan atau reconciliation. Buat langkah ini dari page **Transactions** dalam merchant dashboard. ## Export ke Excel Anda perlu log masuk ke merchant dashboard dahulu. 1. Buka **Transactions**. 2. Klik **Export Excel**, di bahagian atas sebelah kiri page. 3. Dalam pop-up, taip nama fail. 4. Sahkan. Page **Tools** dibuka dan memaparkan export anda. 5. Apabila export itu bertanda selesai, muat turun fail itu. *(Screenshot: Page Transactions dengan butang Export Excel ditanda)* *(Screenshot: Page Excel Exports dengan satu export yang sudah selesai dan butang muat turunnya ditanda)* > **Note** > Export yang besar boleh mengambil masa kira-kira 5 minit untuk siap. Anda boleh tinggalkan page ini dan kembali kemudian. ## Export lain Export untuk bahagian lain dalam merchant dashboard ada dalam [Export data modul](/ms/export-module-data/). Untuk melihat satu bayaran, lihat [Semak transaksi dan statusnya](/ms/transactions/). ## Isu biasa ### Export saya masih belum siap. Berapa lama masa yang diambil? Export yang besar boleh mengambil masa kira-kira 5 minit. Tunggu, kemudian semak page Tools semula. ### Di mana saya boleh cari fail itu selepas saya klik Export Excel? Merchant dashboard akan membuka page Tools. Apabila export itu bertanda selesai, muat turun fail itu dari situ. --- # 把交易导出到Excel > 从商家后台把你的Bayarcash交易下载成Excel文件,以及大型导出处理时要怎么做。 > > Source: https://docs.bayarcash.com/zh/export-transactions/ 你可以把所有交易下载成Excel文件,用来做账或对账。这个操作在商家后台(merchant dashboard)的**Transactions**页面进行。 ## 导出到Excel 你需要先登录商家后台。 1. 打开**Transactions**。 2. 点击页面左上方的**Export Excel**。 3. 在弹窗里输入文件名称。 4. 确认。**Tools**页面会打开,并显示你的导出。 5. 导出标为已完成后,下载文件。 *(Screenshot: Transactions页面,已标示Export Excel按钮)* *(Screenshot: Excel Exports页面,有一个已完成的导出,已标示它的下载按钮)* > **Note** > 大型导出大约需要5分钟才能完成。如果需要,你可以先离开页面,稍后再回来。 ## 其他导出 商家后台其他部分的导出,请看[导出模块资料](/zh/export-module-data/)。如果要查看一笔付款,请看[查看交易和交易状态](/zh/transactions/)。 ## 常见问题 ### 我的导出还没好。需要多久? 大型导出大约需要5分钟。请稍等,然后再查看Tools页面。 ### 点击Export Excel之后,我在哪里找到文件? 商家后台会打开Tools页面。导出标为已完成后,从那里下载文件。 --- # Why did my Bayarcash payment fail? > Find out why a Bayarcash payment failed. Read the FPX or bank message, for example "Bank Declined Transaction", and know what to do next. > > Source: https://docs.bayarcash.com/payment-failed/ A payment can fail because of the customer's bank, their account, or the way the order was sent. The merchant dashboard shows the reason FPX or the bank gave, so you can tell which it is and what to do. ## See why a payment failed Do this in the merchant dashboard. 1. Open **Transactions**. 2. Find the payment and click the eye icon (**View transaction details**). 3. Read the status message. It is the response from FPX (PayNet) or the bank. *(Screenshot: The Transaction Details window with the Status Description and FPX Transaction Status rows highlighted, both showing Insufficient Funds)* The message comes from FPX or the bank. Bayarcash only receives it and shows it to you. For example, if it says Bank Declined Transaction, the customer's bank refused it. ## Transaction statuses Failed payments usually show one of these statuses. | Status | Code | What to do | |---|---|---| | Unsuccessful | 2 | Read the message in the details, then find it in the tables below. | | Cancelled | 4 | The customer cancelled. Ask if they want to try again. | | Abandoned | 5 | The customer left before finishing. Send them the payment link again. | See [Transactions](/transactions/) for the full list. ## Causes and fixes The tables list all 76 FPX response codes from PayNet, the company that runs FPX. Find the message from the transaction details, then do what its group says. ### Approved The payment went through. Nothing to fix. If your shop still shows the order as unpaid, see [Callbacks and checksum](/callbacks-and-checksum/). | Code | Message | |---|---| | 00 | Approved | ### Pending The result is not final yet. Do not ship the order and do not ask the customer to pay again. Check the transaction again later. For code 99, the second approver at the customer's company must approve the payment in their business banking. | Code | Message | |---|---| | 09 | Transaction Pending | | 99 | Pending Authorization (Applicable for B2B model) | ### The customer cancelled or took too long The customer stopped the payment, or the bank session ended. Ask the customer to try again. | Code | Message | |---|---| | 80 | Buyer Cancel Transaction | | BC | Transaction Cancelled By Customer | | OF | Transaction Timeout | | 1M | Internet Banking Session Timeout | | 1A | Buyer Session Timeout At Internet Banking Login Page | | 1B | Buyer Failed To Provide The Necessary Info To Login To Internet Banking Login Page | | 1C | Buyer Choose Cancel At Login Page | | 1D | Buyer Session Timeout At Account Selection Page | | 1E | Buyer Failed To Provide The Necessary Info At Account Selection Page | | 1F | Buyer Choose Cancel At Account Selection Page | | 1G | Buyer Session Timeout At TAC Request Page | | 1H | Buyer Failed To Provide The Necessary Info At TAC Request Page | | 1I | Buyer Choose Cancel At TAC Request Page | | 1J | Buyer Session Timeout At Confirmation Page | | 1K | Buyer Failed To Provide The Necessary Info At Confirmation Page | | 1L | Buyer Choose Cancel At Confirmation Page | ### The customer's account or limit The customer's account cannot make this payment. The customer can use another account, raise the limit with their bank, or pay with another channel. | Code | Message | |---|---| | 51 | Insufficient Funds | | 48 | Maximum Transaction Limit Exceeded | | 2A | Transaction Amount Is Lower Than Minimum Limit | | 14 | Invalid Buyer Account | | 39 | No Credit Account | | 53 | No Buyer Account Number | | 77 | Invalid Buyer Name Or Buyer ID | | 57 | Transaction Not Permitted | ### The bank was not available The problem is at the customer's bank or at FPX. Wait, then try again, or use another bank. To see if a bank is down, check [Bank Status](https://status.bayarcash.com/). | Code | Message | |---|---| | 31 | Invalid Bank | | 92 | Invalid Buyer Bank | | BB | Blocked Bank | | 79 | Host Decline When Down | | 85 | Internal Error At Bank System | | 90 | Bank Internet Banking Unavailable | | OE | Transaction Rejected As Not In FPX Operating Hours | | 87 | Debit Failed Exception Handling | | 88 | Credit Failed Exception Handling | | 89 | Transaction Not Received Exception Handling | ### The order details The order that your shop sent was not accepted. Send a new, unique order number for each payment attempt, in MYR, and check the amount. | Code | Message | |---|---| | 45 | Duplicate Seller Order Number | | XO | Duplicate Exchange Order Number | | XN | Transaction Rejected Due To Duplicate Seller Exchange Order Number | | 13 | Invalid Amount | | 47 | Invalid Currency | | 2X | Transaction Is Canceled By Merchant | ### The merchant set-up A setting for your account at FPX does not match. Contact the Bayarcash team. | Code | Message | |---|---| | 03 | Invalid Merchant | | 05 | Invalid Seller Or Acquiring Bank Code | | SB | Invalid Acquiring Bank Code | | 46 | Invalid Seller Exchange Or Seller | | 49 | Merchant Specific Limit Exceeded | | 50 | Invalid Seller for Merchant Specific Limit | | 58 | Transaction To Merchant Not Permitted | | XA | Invalid Source IP Address (Applicable for B2B2 model) | | XB | Invalid Seller Exchange IP | | XI | Invalid Seller Exchange | | XS | Seller Does Not Belong To Exchange | ### A technical problem A message between the systems failed. Try again. If it happens again, send the order number and the time to the Bayarcash team. | Code | Message | |---|---| | 12 | Invalid Transaction | | 20 | Invalid Response | | 30 | Format Error | | 70 | Invalid Serial Number | | 76 | Transaction Not Found | | 78 | Decryption Failed | | 83 | Invalid Transaction Model | | 84 | Invalid Transaction Type | | 96 | System Malfunction | | 98 | MAC Error | | FE | Internal Error | | XE | Invalid Message | | XF | Invalid Number Of Orders | | XM | Invalid FPX Transaction Model | | XT | Invalid Transaction Type | | XW | Seller Exchange Date Difference Exceeded | ### Direct Debit e-Mandate details These codes are for a Direct Debit enrolment. Check the e-Mandate details, such as the email, the frequency and the bank, then send the enrolment again. See [Direct Debit e-Mandates](/e-mandates/). | Code | Message | |---|---| | DA | Invalid Application Type | | DB | Invalid Email Format | | DC | Invalid Maximum Frequency | | DD | Invalid Frequency Mode | | DE | Invalid Expiry Date | | DF | Invalid e-Mandate Buyer Bank ID | The messages are as PayNet writes them. PayNet's own list has no text for 11 codes (03, 14, 39, 47, 49, 87, BB, OF, XB, XI and 1A). For these codes, the text comes from other FPX providers, and these providers all give the same text. ## Reduce failed payments - **Offer more than one channel.** If one bank is down or refuses, the customer can pay another way. See [Payment channels](/payment-channels/). - **Use a unique order number** every time. - **Keep the amount in MYR** and within your channel's limits. ## Common issues ### The merchant dashboard says Bank Declined Transaction. Is this a Bayarcash problem? No. The message comes from FPX or the customer's bank. Bayarcash shows it for your reference. Ask the customer to check with their bank or try another way to pay. ### The customer says money left their account but the payment shows Unsuccessful. Open the transaction details and note the status message, the order number and the time. Send these to the Bayarcash team so they can check it with the bank. ### I get Duplicate Seller Order Number. What does it mean? The same order number was used before. Send a new, unique order number for every payment attempt. --- # Kenapa bayaran Bayarcash saya gagal? > Ketahui sebab bayaran Bayarcash gagal. Baca mesej daripada FPX atau bank, contohnya "Bank Declined Transaction", dan lihat apa yang perlu dibuat. > > Source: https://docs.bayarcash.com/ms/payment-failed/ Bayaran boleh gagal kerana bank pelanggan, akaun pelanggan, atau cara pesanan itu dihantar. Merchant dashboard memaparkan sebab yang FPX atau bank berikan. Dengan sebab itu, anda tahu punca masalah dan apa yang perlu dibuat. ## Lihat sebab bayaran gagal Buat langkah ini dalam merchant dashboard. 1. Buka **Transactions**. 2. Cari bayaran itu dan klik ikon mata (**View transaction details**). 3. Baca mesej status. Mesej ini ialah respons daripada FPX (PayNet) atau bank. *(Screenshot: Tetingkap Transaction Details dengan baris Status Description dan FPX Transaction Status ditanda, kedua-duanya memaparkan Insufficient Funds)* Mesej itu datang daripada FPX atau bank. Bayarcash hanya menerima mesej itu dan memaparkannya kepada anda. Contohnya, jika mesej itu Bank Declined Transaction, bank pelanggan sudah menolak bayaran itu. ## Status transaksi Bayaran yang gagal biasanya memaparkan salah satu status ini. | Status | Kod | Apa perlu dibuat | |---|---|---| | Unsuccessful | 2 | Baca mesej dalam butiran transaksi, kemudian cari mesej itu dalam jadual di bawah. | | Cancelled | 4 | Pelanggan membatalkan bayaran. Tanya pelanggan sama ada mereka mahu cuba bayar sekali lagi. | | Abandoned | 5 | Pelanggan keluar sebelum bayaran selesai. Hantar link bayaran itu kepada pelanggan sekali lagi. | Senarai penuh status ada dalam [Semak transaksi dan statusnya](/ms/transactions/). ## Punca & penyelesaian Jadual di bawah menyenaraikan kesemua 76 kod respons FPX daripada PayNet, syarikat yang mengendalikan FPX. Cari mesej daripada butiran transaksi dalam jadual. Kemudian ikut tindakan untuk kumpulan mesej itu. ### Diluluskan Bayaran itu berjaya. Tiada apa yang perlu dibetulkan. Jika kedai online anda masih memaparkan pesanan itu sebagai belum dibayar, lihat [Sahkan callback dan checksum](/ms/callbacks-and-checksum/). | Kod | Mesej | |---|---| | 00 | Approved | ### Masih menunggu keputusan Keputusan bayaran belum muktamad. Jangan hantar pesanan itu, dan jangan minta pelanggan bayar sekali lagi. Semak transaksi itu semula kemudian. Untuk kod 99, pelulus kedua di syarikat pelanggan mesti meluluskan bayaran itu dalam business banking syarikat itu. | Kod | Mesej | |---|---| | 09 | Transaction Pending | | 99 | Pending Authorization (Applicable for B2B model) | ### Pelanggan membatalkan bayaran atau masa tamat Pelanggan menghentikan bayaran, atau sesi bank sudah tamat. Minta pelanggan cuba bayar sekali lagi. | Kod | Mesej | |---|---| | 80 | Buyer Cancel Transaction | | BC | Transaction Cancelled By Customer | | OF | Transaction Timeout | | 1M | Internet Banking Session Timeout | | 1A | Buyer Session Timeout At Internet Banking Login Page | | 1B | Buyer Failed To Provide The Necessary Info To Login To Internet Banking Login Page | | 1C | Buyer Choose Cancel At Login Page | | 1D | Buyer Session Timeout At Account Selection Page | | 1E | Buyer Failed To Provide The Necessary Info At Account Selection Page | | 1F | Buyer Choose Cancel At Account Selection Page | | 1G | Buyer Session Timeout At TAC Request Page | | 1H | Buyer Failed To Provide The Necessary Info At TAC Request Page | | 1I | Buyer Choose Cancel At TAC Request Page | | 1J | Buyer Session Timeout At Confirmation Page | | 1K | Buyer Failed To Provide The Necessary Info At Confirmation Page | | 1L | Buyer Choose Cancel At Confirmation Page | ### Akaun atau had pelanggan Akaun pelanggan tidak dapat membuat bayaran ini. Pelanggan boleh guna akaun lain, minta bank menaikkan had, atau bayar melalui saluran bayaran lain. | Kod | Mesej | |---|---| | 51 | Insufficient Funds | | 48 | Maximum Transaction Limit Exceeded | | 2A | Transaction Amount Is Lower Than Minimum Limit | | 14 | Invalid Buyer Account | | 39 | No Credit Account | | 53 | No Buyer Account Number | | 77 | Invalid Buyer Name Or Buyer ID | | 57 | Transaction Not Permitted | ### Bank tidak tersedia Masalah ini berpunca di bank pelanggan atau di FPX. Tunggu sebentar, kemudian minta pelanggan cuba bayar sekali lagi atau guna bank lain. Untuk melihat sama ada sesuatu bank sedang tergendala, semak [Bank Status](https://status.bayarcash.com/). | Kod | Mesej | |---|---| | 31 | Invalid Bank | | 92 | Invalid Buyer Bank | | BB | Blocked Bank | | 79 | Host Decline When Down | | 85 | Internal Error At Bank System | | 90 | Bank Internet Banking Unavailable | | OE | Transaction Rejected As Not In FPX Operating Hours | | 87 | Debit Failed Exception Handling | | 88 | Credit Failed Exception Handling | | 89 | Transaction Not Received Exception Handling | ### Butiran pesanan Pesanan yang kedai online anda hantar tidak diterima. Hantar nombor pesanan baru yang unik untuk setiap cubaan bayaran. Pastikan mata wang ialah MYR, dan semak jumlahnya. | Kod | Mesej | |---|---| | 45 | Duplicate Seller Order Number | | XO | Duplicate Exchange Order Number | | XN | Transaction Rejected Due To Duplicate Seller Exchange Order Number | | 13 | Invalid Amount | | 47 | Invalid Currency | | 2X | Transaction Is Canceled By Merchant | ### Tetapan merchant Satu tetapan akaun anda di FPX tidak sepadan. Hubungi team Bayarcash. | Kod | Mesej | |---|---| | 03 | Invalid Merchant | | 05 | Invalid Seller Or Acquiring Bank Code | | SB | Invalid Acquiring Bank Code | | 46 | Invalid Seller Exchange Or Seller | | 49 | Merchant Specific Limit Exceeded | | 50 | Invalid Seller for Merchant Specific Limit | | 58 | Transaction To Merchant Not Permitted | | XA | Invalid Source IP Address (Applicable for B2B2 model) | | XB | Invalid Seller Exchange IP | | XI | Invalid Seller Exchange | | XS | Seller Does Not Belong To Exchange | ### Masalah teknikal Mesej antara sistem gagal dihantar. Minta pelanggan cuba bayar sekali lagi. Jika masalah berulang, hantar nombor pesanan dan masa transaksi kepada team Bayarcash. | Kod | Mesej | |---|---| | 12 | Invalid Transaction | | 20 | Invalid Response | | 30 | Format Error | | 70 | Invalid Serial Number | | 76 | Transaction Not Found | | 78 | Decryption Failed | | 83 | Invalid Transaction Model | | 84 | Invalid Transaction Type | | 96 | System Malfunction | | 98 | MAC Error | | FE | Internal Error | | XE | Invalid Message | | XF | Invalid Number Of Orders | | XM | Invalid FPX Transaction Model | | XT | Invalid Transaction Type | | XW | Seller Exchange Date Difference Exceeded | ### Butiran e-Mandate Direct Debit Kod ini untuk enrolment Direct Debit. Semak butiran e-Mandate, contohnya e-mel, kekerapan dan bank. Kemudian hantar enrolment itu sekali lagi. Lihat [Semak e-Mandate Direct Debit anda](/ms/e-mandates/). | Kod | Mesej | |---|---| | DA | Invalid Application Type | | DB | Invalid Email Format | | DC | Invalid Maximum Frequency | | DD | Invalid Frequency Mode | | DE | Invalid Expiry Date | | DF | Invalid e-Mandate Buyer Bank ID | Mesej dalam jadual ditulis sama seperti dalam senarai PayNet. Senarai PayNet tidak ada teks untuk 11 kod (03, 14, 39, 47, 49, 87, BB, OF, XB, XI dan 1A). Untuk kod ini, teksnya datang daripada penyedia FPX lain, dan semua penyedia ini memberi teks yang sama. ## Kurangkan bayaran yang gagal Tiga habit ini membantu pelanggan anda membayar dengan berjaya: - **Tawarkan lebih daripada satu saluran bayaran.** Jika satu bank tergendala atau menolak bayaran, pelanggan boleh bayar dengan cara lain. Lihat [Saluran bayaran yang anda boleh terima](/ms/payment-channels/). - **Guna nombor pesanan yang unik** setiap kali. - **Pastikan jumlah dalam MYR** dan dalam had saluran bayaran anda. ## Isu biasa ### Merchant dashboard memaparkan Bank Declined Transaction. Adakah ini masalah Bayarcash? Bukan. Mesej itu datang daripada FPX atau bank pelanggan. Bayarcash hanya memaparkannya sebagai rujukan anda. Minta pelanggan menyemak dengan bank mereka, atau bayar dengan cara lain. ### Pelanggan kata wang sudah keluar dari akaun mereka, tetapi bayaran itu memaparkan Unsuccessful. Apa saya perlu buat? Buka butiran transaksi itu. Catat mesej status, nombor pesanan dan masa transaksi. Hantar butiran ini kepada team Bayarcash, dan mereka akan menyemaknya dengan bank. ### Saya dapat mesej Duplicate Seller Order Number. Apa maksudnya? Nombor pesanan yang sama sudah digunakan sebelum ini. Hantar nombor pesanan baru yang unik untuk setiap cubaan bayaran. --- # 为什么我的Bayarcash付款失败? > 了解Bayarcash付款失败的原因。查看FPX或银行的信息,例如“Bank Declined Transaction”,再决定下一步。 > > Source: https://docs.bayarcash.com/zh/payment-failed/ 付款可能因为顾客的银行、顾客的账户,或订单的发送方式而失败。商家后台(merchant dashboard)会显示FPX或银行给出的原因,让你知道是哪一种情况,以及接下来怎么做。 ## 查看付款失败的原因 在商家后台进行以下步骤。 1. 打开**Transactions**。 2. 找到这笔付款,点击眼睛图标(**View transaction details**)。 3. 阅读状态信息。这是FPX(PayNet)或银行给出的响应。 *(Screenshot: Transaction Details窗口,Status Description和FPX Transaction Status两行已标示,两者都显示Insufficient Funds)* 这条信息来自FPX或银行。Bayarcash只是接收它,再显示给你看。例如,如果信息是Bank Declined Transaction,就表示顾客的银行拒绝了这笔付款。 ## 交易状态 失败的付款通常会显示以下其中一个状态。 | 状态 | 代码 | 怎么做 | |---|---|---| | Unsuccessful | 2 | 阅读详情里的信息,然后在下面的表格中找到它。 | | Cancelled | 4 | 顾客取消了付款。问顾客是否要再试一次。 | | Abandoned | 5 | 顾客在完成付款前离开了。把付款链接再发给顾客一次。 | 完整的状态列表,请看[交易](/zh/transactions/)。 ## 原因与解决方法 下面的表格列出PayNet的全部76个FPX响应代码。PayNet是运营FPX的公司。在表格中找到交易详情里的信息,然后按照该组别的说明去做。 ### 已批准 付款已经成功,不需要修正什么。如果你的网店仍然显示订单未付款,请看[Callback和checksum](/zh/callbacks-and-checksum/)。 | 代码 | 信息 | |---|---| | 00 | Approved | ### 待处理 结果还没有确定。不要发货,也不要叫顾客再付一次。稍后再查看这笔交易。如果是代码99,顾客公司的第二位审批人必须在公司的企业网上银行里批准这笔付款。 | 代码 | 信息 | |---|---| | 09 | Transaction Pending | | 99 | Pending Authorization (Applicable for B2B model) | ### 顾客取消或超时 顾客中止了付款,或银行的会话已经结束。请顾客再试一次。 | 代码 | 信息 | |---|---| | 80 | Buyer Cancel Transaction | | BC | Transaction Cancelled By Customer | | OF | Transaction Timeout | | 1M | Internet Banking Session Timeout | | 1A | Buyer Session Timeout At Internet Banking Login Page | | 1B | Buyer Failed To Provide The Necessary Info To Login To Internet Banking Login Page | | 1C | Buyer Choose Cancel At Login Page | | 1D | Buyer Session Timeout At Account Selection Page | | 1E | Buyer Failed To Provide The Necessary Info At Account Selection Page | | 1F | Buyer Choose Cancel At Account Selection Page | | 1G | Buyer Session Timeout At TAC Request Page | | 1H | Buyer Failed To Provide The Necessary Info At TAC Request Page | | 1I | Buyer Choose Cancel At TAC Request Page | | 1J | Buyer Session Timeout At Confirmation Page | | 1K | Buyer Failed To Provide The Necessary Info At Confirmation Page | | 1L | Buyer Choose Cancel At Confirmation Page | ### 顾客的账户或限额 顾客的账户无法进行这笔付款。顾客可以改用其他账户、请银行提高限额,或用其他付款渠道付款。 | 代码 | 信息 | |---|---| | 51 | Insufficient Funds | | 48 | Maximum Transaction Limit Exceeded | | 2A | Transaction Amount Is Lower Than Minimum Limit | | 14 | Invalid Buyer Account | | 39 | No Credit Account | | 53 | No Buyer Account Number | | 77 | Invalid Buyer Name Or Buyer ID | | 57 | Transaction Not Permitted | ### 银行暂时无法使用 问题出在顾客的银行或FPX。等一等再试,或改用其他银行。要知道某家银行是否故障,请查看[Bank Status](https://status.bayarcash.com/)。 | 代码 | 信息 | |---|---| | 31 | Invalid Bank | | 92 | Invalid Buyer Bank | | BB | Blocked Bank | | 79 | Host Decline When Down | | 85 | Internal Error At Bank System | | 90 | Bank Internet Banking Unavailable | | OE | Transaction Rejected As Not In FPX Operating Hours | | 87 | Debit Failed Exception Handling | | 88 | Credit Failed Exception Handling | | 89 | Transaction Not Received Exception Handling | ### 订单资料 你的网店发送的订单不被接受。每次尝试付款,都要发送一个新的、唯一的订单号码,币种用MYR,并检查金额。 | 代码 | 信息 | |---|---| | 45 | Duplicate Seller Order Number | | XO | Duplicate Exchange Order Number | | XN | Transaction Rejected Due To Duplicate Seller Exchange Order Number | | 13 | Invalid Amount | | 47 | Invalid Currency | | 2X | Transaction Is Canceled By Merchant | ### 商家设置 你的账号在FPX的某项设置不相符。请联系Bayarcash团队。 | 代码 | 信息 | |---|---| | 03 | Invalid Merchant | | 05 | Invalid Seller Or Acquiring Bank Code | | SB | Invalid Acquiring Bank Code | | 46 | Invalid Seller Exchange Or Seller | | 49 | Merchant Specific Limit Exceeded | | 50 | Invalid Seller for Merchant Specific Limit | | 58 | Transaction To Merchant Not Permitted | | XA | Invalid Source IP Address (Applicable for B2B2 model) | | XB | Invalid Seller Exchange IP | | XI | Invalid Seller Exchange | | XS | Seller Does Not Belong To Exchange | ### 技术问题 系统之间的信息传送失败。请再试一次。如果问题再次发生,把订单号码和时间发给Bayarcash团队。 | 代码 | 信息 | |---|---| | 12 | Invalid Transaction | | 20 | Invalid Response | | 30 | Format Error | | 70 | Invalid Serial Number | | 76 | Transaction Not Found | | 78 | Decryption Failed | | 83 | Invalid Transaction Model | | 84 | Invalid Transaction Type | | 96 | System Malfunction | | 98 | MAC Error | | FE | Internal Error | | XE | Invalid Message | | XF | Invalid Number Of Orders | | XM | Invalid FPX Transaction Model | | XT | Invalid Transaction Type | | XW | Seller Exchange Date Difference Exceeded | ### Direct Debit e-Mandate资料 这些代码用于Direct Debit登记。检查e-Mandate资料,例如电邮、频率和银行,然后再次发送登记。请看[查看你的Direct Debit e-Mandate](/zh/e-mandates/)。 | 代码 | 信息 | |---|---| | DA | Invalid Application Type | | DB | Invalid Email Format | | DC | Invalid Maximum Frequency | | DD | Invalid Frequency Mode | | DE | Invalid Expiry Date | | DF | Invalid e-Mandate Buyer Bank ID | 表格中的信息与PayNet的原文相同。PayNet自己的列表中,有11个代码没有文字(03、14、39、47、49、87、BB、OF、XB、XI和1A)。这些代码的文字来自其他FPX服务商,而这些服务商给出的文字都一样。 ## 减少付款失败 以下三个习惯可以帮助顾客顺利付款: - **提供不止一个付款渠道**。如果某家银行故障或拒绝付款,顾客可以用其他方式付款。请看[付款渠道](/zh/payment-channels/)。 - **每次都使用唯一的订单号码**。 - **金额保持为MYR**,并在付款渠道的限额之内。 ## 常见问题 ### 商家后台显示Bank Declined Transaction。这是Bayarcash的问题吗? 不是。这条信息来自FPX或顾客的银行,Bayarcash只是显示出来给你参考。请顾客向银行查询,或改用其他方式付款。 ### 顾客说钱已经从账户扣除,但付款显示Unsuccessful。 打开这笔交易的详情,记下状态信息、订单号码和时间。把这些资料发给Bayarcash团队,让他们向银行查询。 ### 我收到Duplicate Seller Order Number。这是什么意思? 这个订单号码之前已经用过。每次尝试付款,都要发送一个新的、唯一的订单号码。 --- # Create a payment in the merchant dashboard > Add New Transaction starts a payment from the merchant dashboard. It is mainly for internal tests. > > Source: https://docs.bayarcash.com/add-transaction/ **Add New Transaction** starts a payment from the merchant dashboard. You type the details of the customer and the amount, then choose a payment channel. > **Caution** > Bayarcash uses this page mainly for internal tests. To collect payments from your customers, use a [plugin](/woocommerce/), the [API](/developers/) or a payment link from [BCL](/what-is-bayarcash/). ## Create a payment You need the Portal Key of the portal that receives the money. 1. Sign in to the [merchant dashboard](/sign-in/). 2. In the top menu, choose **Transactions**, then choose **Transactions** again. 3. Choose **Add New Transaction**. A **Transaction Details** form opens. 4. Fill in the fields. The table below gives each field. 5. Under **Choose Payment Channel**, choose the button of the payment channel. *(Screenshot: The Transaction Details form with sample values, the Portal Key field and the payment channel buttons highlighted)* The form has these fields: | Field | What to type | |---|---| | **Portal Key** | The key of the portal that receives the money. The link **here** shows where to find it | | **ID Number** | Your own reference for the payment, for example an order number | | **Amount** | The amount in MYR | | **Name**, **Email** and **Mobile Number** | The details of the customer | | **Return URL** | The page that opens after the payment | | **Raw Website Data** | Extra data from your website, if you have it | > **Note** > The form shows all payment channels. A channel works only if it is turned on for the portal. See [Payment channels](/payment-channels/). ## Common issues ### Where do I find the Portal Key for the form? Under the Portal Key field, choose the link here. Or see Find your API keys (/api-keys/). ### Where do I see the payment after the customer pays? In Transactions, like every other payment. See Check a transaction and its status (/transactions/). --- # Buat bayaran dalam merchant dashboard > Add New Transaction memulakan bayaran dari merchant dashboard, dan Bayarcash menggunakannya terutamanya untuk ujian dalaman. > > Source: https://docs.bayarcash.com/ms/add-transaction/ **Add New Transaction** memulakan bayaran dari merchant dashboard. Anda taip butiran pelanggan dan amaun, kemudian pilih saluran bayaran. > **Caution** > Bayarcash menggunakan page ini terutamanya untuk ujian dalaman. Untuk menerima bayaran daripada pelanggan anda, guna [plugin](/ms/woocommerce/), [API](/ms/developers/) atau payment link daripada [BCL](/ms/what-is-bayarcash/). ## Buat bayaran Anda perlukan Portal Key bagi portal yang menerima wang itu. 1. Log masuk ke [merchant dashboard](/ms/sign-in/). 2. Dalam menu atas, klik **Transactions**, kemudian klik **Transactions** sekali lagi. 3. Klik **Add New Transaction**. Form **Transaction Details** dibuka. 4. Isi ruangan dalam form itu. Jadual di bawah menerangkan setiap ruangan. 5. Di bawah **Choose Payment Channel**, klik butang saluran bayaran yang anda mahu. *(Screenshot: Form Transaction Details dengan nilai contoh, dengan ruangan Portal Key dan butang saluran bayaran ditanda)* Form ini ada ruangan berikut: | Ruangan | Apa yang perlu ditaip | |---|---| | **Portal Key** | Key bagi portal yang menerima wang itu. Link **here** menunjukkan tempat untuk mencarinya | | **ID Number** | Rujukan anda sendiri untuk bayaran itu, contohnya nombor pesanan | | **Amount** | Amaun dalam MYR | | **Name**, **Email** dan **Mobile Number** | Butiran pelanggan | | **Return URL** | Page yang dibuka selepas bayaran | | **Raw Website Data** | Data tambahan dari laman web anda, jika ada | > **Note** > Form ini memaparkan semua saluran bayaran. Sesuatu saluran hanya berfungsi jika saluran itu di-on-kan untuk portal. Lihat [Saluran bayaran](/ms/payment-channels/). ## Isu biasa ### Di mana saya boleh cari Portal Key untuk form ini? Di bawah ruangan Portal Key, klik link here. Atau lihat Cari API keys anda (/ms/api-keys/). ### Di mana saya boleh lihat bayaran itu selepas pelanggan membayar? Dalam Transactions, sama seperti bayaran lain. Lihat Semak transaksi dan statusnya (/ms/transactions/). --- # 在商家后台创建付款 > Add New Transaction从商家后台发起一笔付款,主要用于内部测试。 > > Source: https://docs.bayarcash.com/zh/add-transaction/ **Add New Transaction**从商家后台(merchant dashboard)发起一笔付款。你输入顾客资料和金额,然后选择付款渠道。 > **Caution** > Bayarcash主要用这个页面做内部测试。如果要向顾客收款,请使用[插件](/zh/woocommerce/)、[API](/zh/developers/)或[BCL](/zh/what-is-bayarcash/)的付款链接。 ## 创建付款 你需要收款portal的Portal Key。 1. 登录[商家后台](/zh/sign-in/)。 2. 在顶部菜单选择**Transactions**,然后再选择**Transactions**。 3. 选择**Add New Transaction**。**Transaction Details**表单会打开。 4. 填写栏位。下表列出每个栏位。 5. 在**Choose Payment Channel**下方,选择付款渠道的按钮。 *(Screenshot: 填了示例资料的Transaction Details表单,已标示Portal Key栏位和付款渠道按钮)* 表单有这些栏位: | 栏位 | 要输入什么 | |---|---| | **Portal Key** | 收款portal的key。链接**here**会告诉你在哪里找到它 | | **ID Number** | 你自己给这笔付款的参考号码,例如订单号码 | | **Amount** | 金额,以MYR计算 | | **Name**、**Email**和**Mobile Number** | 顾客的资料 | | **Return URL** | 付款后打开的页面 | | **Raw Website Data** | 来自你网站的额外资料(如果有) | > **Note** > 表单会显示所有付款渠道。只有在portal开启了该渠道时,渠道才能使用。请看[付款渠道](/zh/payment-channels/)。 ## 常见问题 ### 表单需要的Portal Key在哪里找? 在Portal Key栏位下方,点击链接here。或者请看找到你的API key (/zh/api-keys/)。 ### 顾客付款后,我在哪里看到这笔付款? 在Transactions里,和其他付款一样。请看查看交易和交易状态 (/zh/transactions/)。 --- # Check a payment, an e-Mandate or a bank without signing in > The Transaction Checker, the e-Mandate Checker and Bank Status are public pages. You and your customers can use them without an account. > > Source: https://docs.bayarcash.com/public-checkers/ Bayarcash has three public pages. You do not sign in to use them, so you can also send them to your customers. The links are at the bottom of every page of the merchant dashboard. ## Check a payment Use the [Transaction Checker](https://check.bayarcash.com/) when a customer asks about a payment. The details come from the bank statement or the email from Bayarcash. 1. Open [check.bayarcash.com](https://check.bayarcash.com/). 2. Type the **Reference Number or Transaction ID**. 3. Type the **Email** of the customer. 4. Choose **Check Transaction**. ## Check an e-Mandate Use the [e-Mandate Checker](https://mandate.bayarcash.com/) for a Direct Debit e-Mandate. 1. Open [mandate.bayarcash.com](https://mandate.bayarcash.com/). 2. Type the **Payment Reference Number**. 3. Type the **Email** of the customer. 4. Choose **Check Mandate**. ## Check the status of the banks [Bank Status](https://status.bayarcash.com/) shows if each FPX bank accepts payments. Use it when payments to one bank fail. 1. Open [status.bayarcash.com](https://status.bayarcash.com/). 2. Choose a tab: **FPX (All)**, **FPX (B2C)**, **FPX (B2B1)** or **FPX (B2B2)**. B2C is for personal accounts. B2B1 and B2B2 are for business accounts. 3. Find the bank. A green tick shows that the bank was available in that minute. A red cross shows a problem. 4. Read **Uptime (7D)** for the availability of the bank in the last 7 days. The page says that the data comes from Payments Network Malaysia (PayNet). For more help with a failed payment, see [Why did my payment fail?](/payment-failed/). ## Common issues ### My customer says they paid. Can they check it? Yes. Send them to the Transaction Checker at check.bayarcash.com. They type the reference number or transaction ID and their email. ### FPX payments to one bank fail. How do I know if the bank has a problem? Open Bank Status at status.bayarcash.com. A red cross next to the bank shows a problem at that time. --- # Semak bayaran, e-Mandate atau bank tanpa log masuk > Transaction Checker, e-Mandate Checker dan Bank Status ialah page awam yang anda dan pelanggan anda boleh guna tanpa akaun. > > Source: https://docs.bayarcash.com/ms/public-checkers/ Bayarcash ada tiga page awam. Anda tidak perlu log masuk untuk menggunakannya, jadi anda juga boleh berikan link page ini kepada pelanggan. Link-nya ada di bahagian bawah setiap page merchant dashboard. ## Semak bayaran Guna [Transaction Checker](https://check.bayarcash.com/) apabila pelanggan bertanya tentang sesuatu bayaran. Butiran yang diperlukan ada pada penyata bank atau e-mel daripada Bayarcash. 1. Buka [check.bayarcash.com](https://check.bayarcash.com/). 2. Taip **Reference Number or Transaction ID**. 3. Taip **Email** pelanggan. 4. Klik **Check Transaction**. ## Semak e-Mandate Guna [e-Mandate Checker](https://mandate.bayarcash.com/) untuk e-Mandate Direct Debit. 1. Buka [mandate.bayarcash.com](https://mandate.bayarcash.com/). 2. Taip **Payment Reference Number**. 3. Taip **Email** pelanggan. 4. Klik **Check Mandate**. ## Semak status bank [Bank Status](https://status.bayarcash.com/) menunjukkan sama ada setiap bank FPX sedang menerima bayaran. Guna page ini apabila bayaran ke satu bank gagal. 1. Buka [status.bayarcash.com](https://status.bayarcash.com/). 2. Klik satu tab: **FPX (All)**, **FPX (B2C)**, **FPX (B2B1)** atau **FPX (B2B2)**. B2C untuk akaun peribadi. B2B1 dan B2B2 untuk akaun perniagaan. 3. Cari bank itu. Tanda hijau menunjukkan bank itu tersedia pada minit tersebut. Pangkah merah menunjukkan masalah. 4. Baca **Uptime (7D)** untuk melihat ketersediaan bank itu dalam 7 hari yang lepas. Page ini menyatakan bahawa datanya datang daripada Payments Network Malaysia (PayNet). Untuk bantuan lanjut tentang bayaran yang gagal, lihat [Kenapa bayaran saya gagal?](/ms/payment-failed/). ## Isu biasa ### Pelanggan saya kata dia sudah bayar. Boleh dia semak sendiri? Boleh. Minta pelanggan buka Transaction Checker di check.bayarcash.com. Pelanggan taip nombor rujukan atau ID transaksi, dan e-mel mereka. ### Bayaran FPX ke satu bank asyik gagal. Bagaimana saya tahu jika bank itu ada masalah? Buka Bank Status di status.bayarcash.com. Pangkah merah di sebelah bank itu menunjukkan masalah pada masa tersebut. --- # 无需登录查询付款、e-Mandate或银行 > Transaction Checker、e-Mandate Checker和Bank Status是公开页面,你和顾客不需要账号也能使用。 > > Source: https://docs.bayarcash.com/zh/public-checkers/ Bayarcash有三个公开页面。你不需要登录就能使用,所以也可以把它们发给你的顾客。这些链接在商家后台(merchant dashboard)每个页面的底部。 ## 查询付款 顾客询问某笔付款时,使用[Transaction Checker](https://check.bayarcash.com/)。所需资料可以在银行结单或Bayarcash发出的电邮里找到。 1. 打开[check.bayarcash.com](https://check.bayarcash.com/)。 2. 输入**Reference Number or Transaction ID**。 3. 输入顾客的**Email**。 4. 点击**Check Transaction**。 ## 查询e-Mandate 要查询Direct Debit e-Mandate,使用[e-Mandate Checker](https://mandate.bayarcash.com/)。 1. 打开[mandate.bayarcash.com](https://mandate.bayarcash.com/)。 2. 输入**Payment Reference Number**。 3. 输入顾客的**Email**。 4. 点击**Check Mandate**。 ## 查看银行状态 [Bank Status](https://status.bayarcash.com/)显示每家FPX银行是否接受付款。某家银行的付款失败时,就用它查看。 1. 打开[status.bayarcash.com](https://status.bayarcash.com/)。 2. 选择一个标签页:**FPX (All)**、**FPX (B2C)**、FPX (B2B1)或**FPX (B2B2)**。B2C用于个人账户。B2B1和B2B2用于商业账户。 3. 找到该银行。绿色勾号表示该银行在那一分钟可用。红色叉号表示有问题。 4. 查看**Uptime (7D)**,了解该银行过去7天的可用率。 页面说明资料来自Payments Network Malaysia(PayNet)。更多关于付款失败的帮助,请看[为什么我的付款失败?](/zh/payment-failed/)。 ## 常见问题 ### 我的顾客说已经付款了。他们可以自己查询吗? 可以。让他们前往check.bayarcash.com的Transaction Checker,输入参考号码或交易ID,以及他们的电邮。 ### 付款到某家银行的FPX付款失败了。我怎样知道是不是银行有问题? 打开status.bayarcash.com的Bank Status。银行旁边的红色叉号表示那个时间有问题。 --- # Payouts: how Bayarcash sends money to your bank > Bayarcash sends your collected payments to your bank account on a schedule, after the fees are deducted. Track each payout by its status. > > Source: https://docs.bayarcash.com/payouts/ Bayarcash collects payments from your customers and settles them to your bank account. Each payout has a status that tells you where it is in the settlement process. ## Check your payouts 1. Open the merchant dashboard. 2. In the top menu, choose **Payouts**, then **Bayarcash Payout**. *(Screenshot: The Payouts menu open on the home page with Bayarcash Payout highlighted)* 3. The page shows all your payouts with their current status. *(Screenshot: The Payouts page with the status totals and the Status column highlighted)* ## Payout statuses | Status | Meaning | |--------|---------| | **Scheduled** | Bayarcash is still receiving payments that will be included in this payout. The payout cutoff has not yet occurred. | | **Processing** | The payout cutoff has passed. The batch is being processed and will be sent to your bank within 1-2 working days. | | **Processing 1** | Money is held at Bayarcash and will be transferred to your bank account within 1-2 working days. | | **Paid** | The payout has been successfully sent to your bank account. | ## Tips **Check the payout schedule.** Payouts follow a fixed cutoff time and settlement schedule. See [Payout schedule](/payout-schedule/) for the day and time of your next payout. **Small amounts wait for the next payout.** A payout needs more than RM10.00 in payments, before fees. A smaller total moves to the next payout. See [Minimum payout](/payout-schedule/#minimum-payout). **Keep your bank account details up to date.** Make sure your registered bank account in the merchant dashboard is correct. If the account details are wrong, a payout can fail or come late. **Other statuses need attention.** The page can also show **Cancelled**, **Postponed**, **Processing 4** and **S/P Exceeds Limit**. If a payout has one of these statuses, contact the Bayarcash team. ## Common issues ### When do I receive my money? Payouts are processed on a T+2 working day basis. See Payout schedule (/payout-schedule/) for exact cutoff times and settlement dates. ### Why did I not get a payout? A payout starts only when the total of its payments is more than RM10.00, before fees. If the total is RM10.00 or less, Bayarcash adds the money to your next payout. See Minimum payout (/payout-schedule/#minimum-payout). ### Why is my payout still 'Processing'? Processing payouts are in progress. They usually complete within 1-2 working days. If a payout stays in Processing for longer, contact support. ### What does 'Scheduled' payout mean? Scheduled means Bayarcash is still receiving payments that will be included in this payout batch. --- # Payout: cara Bayarcash menghantar wang ke akaun bank anda > Bayarcash menghantar bayaran yang dikutip ke akaun bank anda mengikut jadual, selepas caj ditolak. Semak setiap payout mengikut statusnya. > > Source: https://docs.bayarcash.com/ms/payouts/ Bayarcash mengutip bayaran daripada pelanggan anda dan membuat settlement ke akaun bank anda. Setiap payout ada status yang menunjukkan tahap payout itu dalam proses settlement. ## Semak payout anda Semua payout anda ada pada satu page: 1. Buka merchant dashboard. 2. Dalam menu atas, klik **Payouts**, kemudian **Bayarcash Payout**. *(Screenshot: Menu Payouts dibuka pada page utama, dengan Bayarcash Payout ditanda)* 3. Page itu memaparkan semua payout anda bersama status semasanya. *(Screenshot: Page Payouts dengan jumlah bagi setiap status dan lajur Status ditanda)* ## Status payout Setiap payout ada salah satu status ini: | Status | Maksud | |--------|---------| | **Scheduled** | Bayarcash masih menerima bayaran yang akan dimasukkan ke dalam payout ini. Masa cutoff payout belum tiba. | | **Processing** | Masa cutoff payout sudah lepas. Batch ini sedang diproses dan akan dihantar ke bank anda dalam 1-2 hari bekerja. | | **Processing 1** | Wang itu dipegang oleh Bayarcash dan akan dipindahkan ke akaun bank anda dalam 1-2 hari bekerja. | | **Paid** | Payout itu sudah berjaya dihantar ke akaun bank anda. | ## Tips **Semak jadual payout.** Payout mengikut masa cutoff dan jadual settlement yang tetap. Lihat [Jadual payout](/ms/payout-schedule/) untuk hari dan masa payout anda yang seterusnya. **Jumlah yang kecil menunggu payout seterusnya.** Payout memerlukan bayaran melebihi RM10.00, sebelum caj ditolak. Jumlah yang lebih kecil masuk ke payout seterusnya. Lihat [Jumlah minimum payout](/ms/payout-schedule/#jumlah-minimum-payout). **Pastikan butiran akaun bank anda terkini.** Akaun bank yang didaftarkan dalam merchant dashboard mesti betul. Jika butiran akaun salah, payout boleh gagal atau lewat. **Status lain perlu tindakan anda.** Page ini juga boleh memaparkan **Cancelled**, **Postponed**, **Processing 4** dan **S/P Exceeds Limit**. Jika sesuatu payout ada salah satu status ini, hubungi Bayarcash. ## Isu biasa ### Bila saya akan terima wang saya? Payout diproses pada T+2, iaitu 2 hari bekerja kemudian. Lihat Jadual payout (/ms/payout-schedule/) untuk masa cutoff dan tarikh settlement yang tepat. ### Kenapa saya tidak dapat payout? Payout hanya bermula jika jumlah bayarannya melebihi RM10.00, sebelum caj ditolak. Jika jumlahnya RM10.00 atau kurang, Bayarcash memasukkan wang itu ke dalam payout anda yang seterusnya. Lihat Jumlah minimum payout (/ms/payout-schedule/#jumlah-minimum-payout). ### Kenapa payout saya masih 'Processing'? Payout dengan status Processing sedang diproses. Biasanya payout itu selesai dalam 1-2 hari bekerja. Jika payout kekal dalam Processing lebih lama, hubungi Bayarcash. ### Apakah maksud payout 'Scheduled'? Scheduled bermaksud Bayarcash masih menerima bayaran yang akan dimasukkan ke dalam batch payout ini. --- # Payout:Bayarcash如何把钱转入你的银行账户 > Bayarcash扣除手续费后,按时间表把收到的付款转入你的银行账户。你可以按状态追踪每一笔payout。 > > Source: https://docs.bayarcash.com/zh/payouts/ Bayarcash向你的顾客收款,再把钱结算到你的银行账户。每一笔payout(款项转入你的银行账户)都有一个状态,告诉你它在结算过程中的哪个阶段。 ## 查看你的payout 你的所有payout都在同一个页面: 1. 打开商家后台(merchant dashboard)。 2. 在顶部菜单,点击**Payouts**,然后点击**Bayarcash Payout**。 *(Screenshot: 主页上打开的Payouts菜单,已标示Bayarcash Payout)* 3. 页面会显示你的所有payout和它们目前的状态。 *(Screenshot: Payouts页面,已标示各状态总数和Status列)* ## Payout状态 每一笔payout都有以下其中一个状态: | 状态 | 意思 | |--------|---------| | **Scheduled** | Bayarcash还在接收会计入这笔payout的付款。payout截止时间还没到。 | | **Processing** | payout截止时间已过。这一批正在处理,会在1-2个工作日内转到你的银行。 | | **Processing 1** | 钱暂时在Bayarcash,会在1-2个工作日内转入你的银行账户。 | | **Paid** | payout已成功转入你的银行账户。 | ## 小贴士 **查看payout时间表**。Payout有固定的截止时间和结算时间表。请看[Payout结算时间表](/zh/payout-schedule/),了解下一笔payout在哪一天、什么时间开始。 **小额会等到下一笔payout**。一笔payout需要超过RM10.00的付款(扣除手续费前)。较小的总额会转入下一笔payout。请看[最低payout金额](/zh/payout-schedule/#最低payout金额)。 **保持银行账户资料最新**。确保你在商家后台登记的银行账户正确。如果账户资料有误,payout可能会失败或延迟。 **其他状态需要你处理**。页面也可能显示**Cancelled**、**Postponed**、**Processing 4**和**S/P Exceeds Limit**。如果payout出现其中一个状态,请联系Bayarcash团队。 ## 常见问题 ### 我什么时候会收到钱? Payout按T+2个工作日处理。确切的截止时间和结算日期,请看Payout结算时间表 (/zh/payout-schedule/)。 ### 为什么我没有收到payout? 只有付款总额在扣除手续费前超过RM10.00,payout才会开始。如果总额是RM10.00或更少,Bayarcash会把这笔钱加入你的下一笔payout。请看最低payout金额 (/zh/payout-schedule/#最低payout金额)。 ### 为什么我的payout还是“Processing”? Processing的payout正在处理中,通常在1-2个工作日内完成。如果payout停留在Processing太久,请联系支持团队。 ### “Scheduled”的payout是什么意思? Scheduled表示Bayarcash还在接收会计入这一批payout的付款。 --- # Payout settlement schedule > Payouts are processed on a T+2 working day basis with a daily cutoff at midnight. > > Source: https://docs.bayarcash.com/payout-schedule/ Bayarcash pays out on a T+2 working day basis. A payment that you receive before the daily cutoff goes to your bank 2 working days later. ## How the schedule works | Payment received before 12:00 AM on | Payout starts after 5:00 PM on | |---|---| | Monday | Wednesday | | Tuesday | Thursday | | Wednesday | Friday | | Thursday | Monday | | Friday | Tuesday | | Saturday | Tuesday | | Sunday | Tuesday | The table starts today. The dates and the green row use Malaysia time. The table shows the usual payout days, and it marks a payout day that a public holiday moves. ## Public holidays Bayarcash does not pay out on a public holiday in Kuala Lumpur. The 2 working days (T+2) do not count these holidays, the same as a Saturday or a Sunday. A holiday that is only in a different state does not change the payouts. For the list of holidays, the next payout after each one, a payout date checker and a calendar file, read [Public holidays and payouts](/public-holidays/). ## Minimum payout A payout starts only when its total is more than RM10.00. Bayarcash uses the total of the customer payments before the fees. If the total is RM10.00 or less, Bayarcash does not pay out on that day. It adds the money to the next payout. When the total is more than RM10.00, the payout starts on the usual schedule. For the payout statuses and how to check your payouts, see [Payouts to your bank account](/payouts/). ## Tips **Plan your cash flow around T+2.** If you need money faster, plan ahead or ask the Bayarcash team about other settlement options. **Check your payout history.** Open **Payouts** in your merchant dashboard to see all past and upcoming payouts, their status and their dates. ## Common issues ### Why did I not get a payout today? The total of your payments in this payout was RM10.00 or less, before fees. Bayarcash pays out only more than RM10.00. The money is not lost: Bayarcash adds it to your next payout. ### What time is the payout cutoff? The cutoff is 12:00 AM (midnight) every day. Payments received before midnight are included in that day's payout batch. ### Do you process payouts on weekends? No. Bayarcash does not pay out on Saturdays, Sundays or public holidays in Kuala Lumpur. The 2 working days do not count these days, so a payout moves to the next working day. See Public holidays and payouts (/public-holidays/). ### When will I see the money in my bank? Payouts are initiated after 5:00 PM on the scheduled payout day. When it reaches your account after that depends on your bank. --- # Jadual payout > Bayarcash memproses payout pada T+2 hari bekerja, dengan cutoff harian pada tengah malam. > > Source: https://docs.bayarcash.com/ms/payout-schedule/ Bayarcash membuat payout pada T+2 hari bekerja. Bayaran yang anda terima sebelum cutoff harian masuk ke bank anda 2 hari bekerja kemudian. ## Cara jadual ini berfungsi | Hari bayaran diterima (sebelum 12:00 AM) | Hari payout bermula (selepas 5:00 PM) | |---|---| | Isnin | Rabu | | Selasa | Khamis | | Rabu | Jumaat | | Khamis | Isnin | | Jumaat | Selasa | | Sabtu | Selasa | | Ahad | Selasa | Jadual ini bermula dengan hari ini. Tarikh dan baris hijau mengikut waktu Malaysia. Jadual ini menunjukkan hari payout biasa, dan menandakan hari payout yang berubah kerana cuti umum. ## Cuti umum Bayarcash tidak membuat payout pada cuti umum di Kuala Lumpur. Kiraan 2 hari bekerja (T+2) tidak termasuk cuti ini, sama seperti hari Sabtu dan Ahad. Cuti yang hanya ada di negeri lain tidak mengubah tarikh payout. Untuk senarai cuti, payout seterusnya selepas setiap cuti, penyemak tarikh payout dan fail kalendar, lihat [Cuti umum dan payout](/ms/public-holidays/). ## Jumlah minimum payout Payout hanya bermula jika jumlahnya melebihi RM10.00. Bayarcash mengira jumlah bayaran pelanggan sebelum caj ditolak. Jika jumlahnya RM10.00 atau kurang, Bayarcash tidak membuat payout pada hari itu. Wang itu dimasukkan ke dalam payout yang seterusnya. Apabila jumlahnya melebihi RM10.00, payout bermula mengikut jadual biasa. Untuk status payout dan cara menyemak payout anda, lihat [Payout ke akaun bank anda](/ms/payouts/). ## Tips **Rancang aliran tunai anda berdasarkan T+2.** Jika anda perlukan wang lebih cepat, rancang lebih awal atau tanya Bayarcash tentang pilihan settlement yang lain. **Semak sejarah payout anda.** Buka **Payouts** dalam merchant dashboard anda untuk melihat semua payout yang lepas dan yang akan datang, bersama status dan tarikhnya. ## Isu biasa ### Kenapa saya tidak dapat payout hari ini? Jumlah bayaran dalam payout ini ialah RM10.00 atau kurang, sebelum caj ditolak. Bayarcash hanya membuat payout jika jumlahnya melebihi RM10.00. Wang anda tidak hilang. Bayarcash memasukkannya ke dalam payout anda yang seterusnya. ### Pukul berapa cutoff payout? Cutoff ialah 12:00 AM (tengah malam) setiap hari. Bayaran yang diterima sebelum tengah malam dimasukkan ke dalam batch payout hari itu. ### Adakah payout diproses pada hujung minggu? Tidak. Bayarcash tidak membuat payout pada hari Sabtu, Ahad atau cuti umum di Kuala Lumpur. Kiraan 2 hari bekerja tidak termasuk hari-hari ini, jadi payout berpindah ke hari bekerja seterusnya. Lihat Cuti umum dan payout (/ms/public-holidays/). ### Bila wang itu akan masuk ke akaun bank saya? Payout dimulakan selepas 5:00 PM pada hari payout yang dijadualkan. Selepas itu, masa wang sampai ke akaun anda bergantung pada bank anda. --- # Payout结算时间表 > Payout按T+2个工作日处理,每天的截止时间是午夜12点。 > > Source: https://docs.bayarcash.com/zh/payout-schedule/ Bayarcash按T+2个工作日进行payout(款项转入你的银行账户)。你在每日截止时间前收到的付款,会在2个工作日后转入你的银行。 ## 时间表如何运作 | 在这天12:00 AM前收到付款 | Payout在这天5:00 PM后开始 | |---|---| | 星期一 | 星期三 | | 星期二 | 星期四 | | 星期三 | 星期五 | | 星期四 | 星期一 | | 星期五 | 星期二 | | 星期六 | 星期二 | | 星期日 | 星期二 | 这个表从今天开始。日期和绿色那一行都按马来西亚时间。表里显示平常的payout日,并标出因公共假期而顺延的payout日。 ## 公共假期 Bayarcash在吉隆坡的公共假期不会进行payout。2个工作日(T+2)不计算这些假期,和星期六、星期日一样。只在其他州放的假期不会改变payout日期。 假期列表、每个假期后的下一次payout、payout日期查询工具和日历文件,请看[公共假期和payout](/zh/public-holidays/)。 ## 最低payout金额 只有总额超过RM10.00时,payout才会开始。Bayarcash按扣除手续费前的顾客付款总额计算。 如果总额是RM10.00或更少,Bayarcash当天不会进行payout,而是把这笔钱加入下一笔payout。总额超过RM10.00时,payout会按平常的时间表开始。 payout状态和查看payout的方法,请看[Payout:Bayarcash如何把钱转入你的银行账户](/zh/payouts/)。 ## 小贴士 **按T+2规划你的现金流**。如果你需要更快拿到钱,请提早规划,或向Bayarcash团队询问其他结算选项。 **查看你的payout记录**。在商家后台(merchant dashboard)打开**Payouts**,查看所有过去和即将到来的payout,以及它们的状态和日期。 ## 常见问题 ### 为什么我今天没有收到payout? 这笔payout里的付款总额,在扣除手续费前是RM10.00或更少。Bayarcash只在总额超过RM10.00时才进行payout。钱不会不见:Bayarcash会把它加入你的下一笔payout。 ### Payout的截止时间是几点? 截止时间是每天12:00 AM(午夜)。午夜前收到的付款,会计入当天的payout批次。 ### 周末会处理payout吗? 不会。Bayarcash在星期六、星期日和吉隆坡的公共假期不会进行payout。2个工作日不计算这些日子,所以payout会顺延到下一个工作日。请看公共假期和payout (/zh/public-holidays/)。 ### 钱什么时候会进入我的银行账户? Payout在预定payout日的5:00 PM后开始。之后钱什么时候到你的账户,要看你的银行。 --- # Public holidays and payouts > The public holidays with no Bayarcash payout, the next payout date after each one, and a calendar file for your team. > > Source: https://docs.bayarcash.com/public-holidays/ Bayarcash does not pay out on a public holiday in Kuala Lumpur. The 2 working days (T+2) do not count these holidays, the same as a Saturday or a Sunday. This applies to all payouts. The holidays are the national holidays and the Kuala Lumpur holidays (New Year's Day, Thaipusam, Federal Territory Day and Nuzul Al-Quran). A holiday that is only in a different state does not change the payouts. ## How a holiday moves a payout A payment that you receive before the 12:00 AM cutoff goes to your bank 2 working days later, after 5:00 PM. A holiday is not a working day. So when a holiday falls on the payout day, or between the payment and the payout, the payout moves 1 working day later. For example, Monday 9 November 2026 was the Deepavali replacement holiday: - A payment on Thursday 5 November went to the bank on Tuesday 10 November, not on Monday 9 November. - A payment on Friday 6 November went to the bank on Wednesday 11 November, not on Tuesday 10 November. The "Next payout" column shows the first payout after each holiday. That payout has the payments that the holiday delayed. ## Add the holidays to your calendar Add the days with no payout to Google Calendar, Outlook or Apple Calendar: 1. Copy this link: `https://docs.bayarcash.com/public-holidays.ics` 2. In Google Calendar, select **Other calendars** > **+** > **From URL**, then paste the link. 3. In Outlook, select **Add calendar** > **Subscribe from web**, then paste the link. When we add the holidays of the next year, your calendar gets them. You can also [download the calendar file](/public-holidays.ics). To see the cutoff and the payout days of this week, read [Payout settlement schedule](/payout-schedule/). ## Common issues ### Which public holidays stop payouts? The public holidays in Kuala Lumpur. These are the national holidays and the Kuala Lumpur holidays: New Year's Day, Thaipusam, Federal Territory Day and Nuzul Al-Quran. This applies to all payouts. ### Does a state holiday in my state stop my payout? No. A holiday that is only in a different state, for example Hari Raya Qurban (second day) in Kelantan and Terengganu, does not change the payout date. Your bank can still take more time to show the money. ### What happens when the government announces a new holiday? Bayarcash does not pay out on that day, and the payouts move to the next working day. We add the day to this page when it is announced. ### Why is my payout 2 days later than I expected? A holiday on the payout day or before it moves the payout. T+2 counts only working days. Use the payout date checker on this page to see the date for your payment. --- # Cuti umum dan payout > Cuti umum tanpa payout Bayarcash, tarikh payout seterusnya selepas setiap cuti, dan fail kalendar untuk pasukan anda. > > Source: https://docs.bayarcash.com/ms/public-holidays/ Bayarcash tidak membuat payout pada cuti umum di Kuala Lumpur. Kiraan 2 hari bekerja (T+2) tidak termasuk cuti ini, sama seperti hari Sabtu dan Ahad. Peraturan ini terpakai untuk semua payout. Cuti ini ialah cuti umum kebangsaan dan cuti Kuala Lumpur (Tahun Baharu, Hari Thaipusam, Hari Wilayah Persekutuan dan Hari Nuzul Al-Quran). Cuti yang hanya ada di negeri lain tidak mengubah tarikh payout. ## Bagaimana cuti mengubah tarikh payout Bayaran yang anda terima sebelum cutoff 12:00 AM masuk ke bank anda 2 hari bekerja kemudian, selepas 5:00 PM. Cuti umum bukan hari bekerja. Jadi, jika cuti jatuh pada hari payout, atau antara hari bayaran dan hari payout, payout berpindah 1 hari bekerja kemudian. Contohnya, Isnin 9 November 2026 ialah cuti gantian Deepavali: - Bayaran pada Khamis 5 November masuk ke bank pada Selasa 10 November, bukan pada Isnin 9 November. - Bayaran pada Jumaat 6 November masuk ke bank pada Rabu 11 November, bukan pada Selasa 10 November. Lajur "Payout seterusnya" menunjukkan payout pertama selepas setiap cuti. Payout itu termasuk bayaran yang tertangguh kerana cuti itu. ## Tambah cuti ke kalendar anda Tambah hari tanpa payout ke Google Calendar, Outlook atau Apple Calendar: 1. Copy link ini: `https://docs.bayarcash.com/public-holidays.ics` 2. Dalam Google Calendar, pilih **Other calendars** → **+** → **From URL**, kemudian paste link itu. 3. Dalam Outlook, pilih **Add calendar** → **Subscribe from web**, kemudian paste link itu. Apabila kami menambah cuti tahun seterusnya, kalendar anda akan menerimanya secara automatik. Anda juga boleh [muat turun fail kalendar](/public-holidays.ics). Untuk melihat cutoff dan hari payout minggu ini, lihat [Jadual payout](/ms/payout-schedule/). ## Isu biasa ### Pada cuti umum yang mana Bayarcash tidak membuat payout? Cuti umum di Kuala Lumpur, iaitu cuti umum kebangsaan dan cuti Kuala Lumpur: Tahun Baharu, Hari Thaipusam, Hari Wilayah Persekutuan dan Hari Nuzul Al-Quran. Peraturan ini terpakai untuk semua payout. ### Adakah cuti negeri di negeri saya mengubah tarikh payout saya? Tidak. Cuti yang hanya ada di negeri lain, contohnya Hari Raya Qurban (Hari Kedua) di Kelantan dan Terengganu, tidak mengubah tarikh payout. Tetapi bank anda mungkin mengambil masa lebih lama untuk memaparkan wang itu. ### Apa yang berlaku jika kerajaan mengumumkan cuti baru? Bayarcash tidak membuat payout pada hari itu, dan payout berpindah ke hari bekerja seterusnya. Kami menambah hari itu pada page ini selepas cuti itu diumumkan. ### Kenapa payout saya 2 hari lebih lewat daripada yang saya jangka? Cuti pada hari payout atau sebelumnya menjadikan payout lebih lewat. T+2 hanya mengira hari bekerja. Gunakan penyemak tarikh payout pada page ini untuk melihat tarikh payout bagi bayaran anda. --- # 公共假期和payout > 没有Bayarcash payout的公共假期、每个假期后的下一次payout日期,以及给你团队用的日历文件。 > > Source: https://docs.bayarcash.com/zh/public-holidays/ Bayarcash在吉隆坡的公共假期不会进行payout。2个工作日(T+2)不计算这些假期,和星期六、星期日一样。这适用于所有payout。 这些假期是全国公共假期和吉隆坡的假期(元旦、大宝森节、联邦直辖区日和可兰经降世日)。只在其他州放的假期不会改变payout日期。 ## 假期如何影响payout 在12:00 AM截止时间前收到的付款,会在2个工作日后的5:00 PM后转入你的银行。公共假期不是工作日。所以,如果假期落在payout日,或在付款日和payout日之间,payout会顺延1个工作日。 例如,2026年11月9日星期一是屠妖节补假: - 11月5日星期四的付款,在11月10日星期二转入银行,而不是11月9日星期一。 - 11月6日星期五的付款,在11月11日星期三转入银行,而不是11月10日星期二。 “下一次payout”一栏显示每个假期后的第一次payout。这次payout包括因为假期而延后的付款。 ## 把假期加入你的日历 把没有payout的日子加入Google Calendar、Outlook或Apple Calendar: 1. 复制这个链接:`https://docs.bayarcash.com/public-holidays.ics` 2. 在Google Calendar,选择**Other calendars** → **+** → **From URL**,然后粘贴链接。 3. 在Outlook,选择**Add calendar** → **Subscribe from web**,然后粘贴链接。 我们加入下一年的假期后,你的日历会自动更新。你也可以[下载日历文件](/public-holidays.ics)。 想看这个星期的截止时间和payout日,请看[Payout结算时间表](/zh/payout-schedule/)。 ## 常见问题 ### 哪些公共假期没有payout? 吉隆坡的公共假期,也就是全国公共假期和吉隆坡的假期:元旦、大宝森节、联邦直辖区日和可兰经降世日。这适用于所有payout。 ### 我所在州的州假期会改变payout日期吗? 不会。只在其他州放的假期,例如吉兰丹和登嘉楼的哈芝节(第二天),不会改变payout日期。不过,你的银行可能需要更多时间才显示这笔钱。 ### 如果政府宣布新的假期,会怎样? Bayarcash当天不会进行payout,payout会顺延到下一个工作日。假期公布后,我们会把它加到这个页面。 ### 为什么我的payout比我预期的晚了2天? payout日或之前的假期会让payout顺延。T+2只计算工作日。用这个页面上的payout日期查询工具,查看你那笔付款的payout日期。 --- # Payout calculator > Work out the platform fee, the SST on it and the amount you receive for a sale, for each Bayarcash payment channel. > > Source: https://docs.bayarcash.com/payout-calculator/ Use this calculator to see how much you receive from a sale after the Bayarcash platform fee and SST. ## How the amount is calculated 1. The platform fee is the percentage fee on the sales amount plus the fixed fee. 2. SST is 8% of the platform fee. 3. You receive the sales amount minus the platform fee and the SST. Bayarcash rounds the fee and the SST to the nearest sen. ## Standard fees by payment method | Payment method | Fee | Settlement | |---|---|---| | **Online banking** | | | | FPX personal banking (B2C) | RM 1.00 | T+2 | | FPX business banking (B2B) | RM 2.00 | T+2 | | FPX Line of Credit (CCA): Malaysian credit card account | RM 1.00 + 1.00% | T+2 | | **Recurring** | | | | Direct Debit: enrolment, maintenance or termination (by FPX) | RM 1.00 | T+2 | | Direct Debit: each deduction | RM 1.50 | T+2 | | **Cards** (apply separately) | | | | Malaysian credit card (Visa, Mastercard) | 1.50% | T+2 | | Overseas credit card (Visa, Mastercard) | 3.50% | T+2 | | Debit card (MyDebit) | 1.00% | T+2 | | **DuitNow QR (online and at the counter)** | | | | DuitNow QR | 1.60%, minimum RM 0.15 | T+2 | | Cross-border QR (NETS, QRIS, PromptPay, Alipay, WeChat Pay) | 1.60%, minimum RM 0.15 | T+2 | | **E-wallets** (apply separately) | | | | Touch 'n Go eWallet | 1.50% | T+2 | | GrabPay | 1.50% | T+2 | | Boost Wallet | 1.50% | T+2 | | ShopeePay | 1.50% | T+2 | | **Buy now, pay later** (apply separately) | | | | Boost PayFlex | 1.50% | T+2 | | PayLater by Grab | 1.50% | T+2 | | SPayLater | 1.50% | T+2 | Bayarcash settles every payment method on a T+2 basis. See [Payout settlement schedule](/payout-schedule/). Bayarcash charges the Direct Debit deduction fee for each deduction, successful or not. It charges the enrolment, maintenance and termination fee only when the bank verification is successful. For the channels marked **Apply separately**, apply to Bayarcash before you can use them. Bayarcash charges these fees, and the fees can change. To see when the money reaches your bank, read [Payout settlement schedule](/payout-schedule/). ## Common issues ### Is SST charged on my sale? No. Bayarcash charges SST at 8% on the platform fee only, not on the sales amount. ### Are these the fees on my account? They are the standard rates. Your agreement with Bayarcash can have different rates. If you are not sure, contact the Bayarcash team. --- # Kalkulator payout > Kira caj platform, SST pada caj itu dan amaun yang anda terima bagi sesuatu jualan, untuk setiap saluran bayaran Bayarcash. > > Source: https://docs.bayarcash.com/ms/payout-calculator/ Guna kalkulator ini untuk melihat amaun yang anda terima daripada sesuatu jualan, selepas caj platform Bayarcash dan SST. ## Cara amaun dikira Kalkulator ini mengira amaun anda dalam tiga langkah: 1. Caj platform ialah caj peratusan pada jumlah jualan, ditambah caj tetap. 2. SST ialah 8% daripada caj platform. 3. Anda terima jumlah jualan, tolak caj platform dan SST. Bayarcash membundarkan caj dan SST kepada sen yang terdekat. ## Caj standard mengikut kaedah bayaran | Kaedah bayaran | Caj | Settlement | |---|---|---| | **Online banking** | | | | FPX akaun peribadi (B2C) | RM 1.00 | T+2 | | FPX akaun perniagaan (B2B) | RM 2.00 | T+2 | | FPX Line of Credit (CCA): akaun kad kredit Malaysia | RM 1.00 + 1.00% | T+2 | | **Bayaran berulang** | | | | Direct Debit: enrolment, maintenance atau termination (melalui FPX) | RM 1.00 | T+2 | | Direct Debit: setiap potongan | RM 1.50 | T+2 | | **Kad** (mohon berasingan) | | | | Kad kredit Malaysia (Visa, Mastercard) | 1.50% | T+2 | | Kad kredit luar negara (Visa, Mastercard) | 3.50% | T+2 | | Kad debit (MyDebit) | 1.00% | T+2 | | **DuitNow QR (online dan di kaunter)** | | | | DuitNow QR | 1.60%, minimum RM 0.15 | T+2 | | QR cross-border (NETS, QRIS, PromptPay, Alipay, WeChat Pay) | 1.60%, minimum RM 0.15 | T+2 | | **E-wallet** (mohon berasingan) | | | | Touch 'n Go eWallet | 1.50% | T+2 | | GrabPay | 1.50% | T+2 | | Boost Wallet | 1.50% | T+2 | | ShopeePay | 1.50% | T+2 | | **Buy now, pay later** (mohon berasingan) | | | | Boost PayFlex | 1.50% | T+2 | | PayLater by Grab | 1.50% | T+2 | | SPayLater | 1.50% | T+2 | Bayarcash membuat settlement untuk setiap kaedah bayaran pada T+2. Lihat [Jadual payout](/ms/payout-schedule/). Bayarcash mengenakan caj potongan Direct Debit untuk setiap potongan, sama ada berjaya atau tidak. Caj enrolment, maintenance dan termination hanya dikenakan apabila pengesahan bank berjaya. Untuk saluran yang bertanda **Mohon berasingan**, mohon kepada Bayarcash dahulu sebelum anda boleh menggunakannya. Bayarcash yang menetapkan caj ini, dan caj ini boleh berubah. Untuk melihat bila wang sampai ke bank anda, baca [Jadual payout](/ms/payout-schedule/). ## Isu biasa ### Adakah SST dikenakan pada jualan saya? Tidak. Bayarcash mengenakan SST 8% pada caj platform sahaja, bukan pada jumlah jualan. ### Adakah ini caj untuk akaun saya? Ini ialah rate standard. Perjanjian anda dengan Bayarcash mungkin ada rate yang berbeza. Jika anda tidak pasti, hubungi Bayarcash. --- # Payout计算器 > 为每个Bayarcash付款渠道,算出一笔销售的平台手续费、手续费的SST,以及你会收到的金额。 > > Source: https://docs.bayarcash.com/zh/payout-calculator/ 用这个计算器,看看扣除Bayarcash平台手续费和SST后,你从一笔销售收到多少。 ## 金额如何计算 计算器分三步算出你的金额: 1. 平台手续费是销售额的百分比手续费,加上固定手续费。 2. SST是平台手续费的8%。 3. 你收到的是销售额减去平台手续费和SST。 Bayarcash会把手续费和SST四舍五入到最接近的仙。 ## 各付款方式的标准手续费 | 付款方式 | 手续费 | 结算 | |---|---|---| | **Online banking** | | | | FPX个人网上银行(B2C) | RM 1.00 | T+2 | | FPX企业网上银行(B2B) | RM 2.00 | T+2 | | FPX Line of Credit(CCA):马来西亚信用卡账户 | RM 1.00 + 1.00% | T+2 | | **定期付款** | | | | Direct Debit:登记、修改或终止(通过FPX) | RM 1.00 | T+2 | | Direct Debit:每次扣款 | RM 1.50 | T+2 | | **卡** (需另外申请) | | | | 马来西亚信用卡(Visa、Mastercard) | 1.50% | T+2 | | 海外信用卡(Visa、Mastercard) | 3.50% | T+2 | | 借记卡(MyDebit) | 1.00% | T+2 | | **DuitNow QR(线上和柜台)** | | | | DuitNow QR | 1.60%,最低RM 0.15 | T+2 | | 跨境QR码(NETS、QRIS、PromptPay、Alipay、WeChat Pay) | 1.60%,最低RM 0.15 | T+2 | | **电子钱包** (需另外申请) | | | | Touch 'n Go eWallet | 1.50% | T+2 | | GrabPay | 1.50% | T+2 | | Boost Wallet | 1.50% | T+2 | | ShopeePay | 1.50% | T+2 | | **Buy now, pay later** (需另外申请) | | | | Boost PayFlex | 1.50% | T+2 | | PayLater by Grab | 1.50% | T+2 | | SPayLater | 1.50% | T+2 | Bayarcash对每种付款方式都按T+2结算。请看[Payout结算时间表](/zh/payout-schedule/)。 Direct Debit的扣款手续费按每次扣款收取,不论成功与否。登记、修改和终止的手续费只在银行验证成功时才收取。标示**Apply separately**的渠道,你要先向Bayarcash申请才能使用。 这些手续费由Bayarcash收取,而且可能会改变。想知道钱什么时候到你的银行,请看[Payout结算时间表](/zh/payout-schedule/)。 ## 常见问题 ### 我的销售额要收SST吗? 不用。Bayarcash只对平台手续费收取8%的SST,不对销售额收取。 ### 这些是我账号的手续费吗? 这些是标准费率。你与Bayarcash的协议可能有不同的费率。如果不确定,请联系Bayarcash团队。 --- # Check your payout bank account > See the bank account that receives your Bayarcash payouts, and how to change it through your account manager. > > Source: https://docs.bayarcash.com/payout-bank/ Bayarcash sends your payouts to one bank account. The **Payout Bank** page shows that account. Check it before your first payout, and after any change to your business bank. ## See your payout bank account You can see the account, but you cannot change it here. 1. Sign in to the [merchant dashboard](/sign-in/). 2. In the top menu, choose **Profile**. 3. Choose **Payout Bank**. *(Screenshot: The Payout Bank page with sample details, account number blurred)* The page shows these fields: | Field | What it shows | |---|---| | **Account Holder** | The name on the bank account | | **Bank** | The bank that receives your payouts | | **Account Number** | The account number that receives your payouts | ## Change your payout bank account The page says: "Please contact your account manager for any changes in bank details." Speak to your account manager before you close the old account. If the account is wrong, a payout can fail or go to the wrong place. To follow your payouts, see [Payouts to your bank account](/payouts/). ## Common issues ### How do I change the bank account for my payouts? You cannot change it in the merchant dashboard. Contact your account manager. The Payout Bank page also says this. ### My payout went to an old account. What do I do? Open Profile → Payout Bank and check the account. If it is wrong, contact your account manager immediately. --- # Semak akaun bank untuk payout anda > Lihat akaun bank yang menerima payout Bayarcash anda, dan cara menukarnya melalui account manager anda. > > Source: https://docs.bayarcash.com/ms/payout-bank/ Bayarcash menghantar payout anda ke satu akaun bank. Page **Payout Bank** menunjukkan akaun itu. Semak akaun itu sebelum payout pertama anda, dan selepas sebarang perubahan pada akaun bank perniagaan anda. ## Lihat akaun bank payout anda Anda boleh lihat akaun itu di sini, tetapi anda tidak boleh menukarnya. 1. Log masuk ke [merchant dashboard](/ms/sign-in/). 2. Dalam menu atas, klik **Profile**. 3. Klik **Payout Bank**. *(Screenshot: Page Payout Bank dengan butiran contoh, dan nombor akaun dikaburkan)* Page ini memaparkan ruangan berikut: | Ruangan | Apa yang dipaparkan | |---|---| | **Account Holder** | Nama pada akaun bank | | **Bank** | Bank yang menerima payout anda | | **Account Number** | Nombor akaun yang menerima payout anda | ## Tukar akaun bank payout anda Page ini menyatakan: "Please contact your account manager for any changes in bank details." Bincang dengan account manager anda sebelum anda menutup akaun lama. Jika akaun itu salah, payout boleh gagal atau masuk ke akaun yang salah. Untuk mengikuti payout anda, lihat [Payout ke akaun bank anda](/ms/payouts/). ## Isu biasa ### Bagaimana saya tukar akaun bank untuk payout saya? Anda tidak boleh menukarnya dalam merchant dashboard. Hubungi account manager anda. Page Payout Bank juga menyatakan perkara ini. ### Payout saya masuk ke akaun lama. Apa yang perlu saya buat? Buka Profile → Payout Bank dan semak akaun itu. Jika akaun itu salah, hubungi account manager anda dengan segera. --- # 查看你的payout银行账户 > 查看接收你Bayarcash payout的银行账户,以及如何通过你的客户经理更换它。 > > Source: https://docs.bayarcash.com/zh/payout-bank/ Bayarcash把你的payout(款项转入你的银行账户)转入一个银行账户。**Payout Bank**页面显示这个账户。请在第一次payout之前,以及你的公司银行账户有任何变动之后,检查这个账户。 ## 查看你的payout银行账户 你可以在这里查看账户,但不能在这里更换。 1. 登录[商家后台(merchant dashboard)](/zh/sign-in/)。 2. 在顶部菜单选择**Profile**。 3. 选择**Payout Bank**。 *(Screenshot: 显示示例资料的Payout Bank页面,账户号码已模糊处理)* 页面显示这些栏位: | 栏位 | 显示什么 | |---|---| | **Account Holder** | 银行账户上的名字 | | **Bank** | 接收你payout的银行 | | **Account Number** | 接收你payout的账户号码 | ## 更换你的payout银行账户 页面写着:“Please contact your account manager for any changes in bank details.” 在关闭旧账户之前,请先和你的客户经理联系。如果账户不对,payout可能会失败,或转到错误的地方。 如果要跟进你的payout,请看[转入你银行账户的payout](/zh/payouts/)。 ## 常见问题 ### 我要怎样更换接收payout的银行账户? 你不能在商家后台更换。请联系你的客户经理。Payout Bank页面也是这样说明的。 ### 我的payout转入了旧账户。我该怎么做? 打开Profile → Payout Bank,检查账户。如果账户不对,请马上联系你的客户经理。 --- # Your Bayarcash wallet (deprecated) > Deprecated. How the old Bayarcash wallet worked, kept as a record. > > Source: https://docs.bayarcash.com/wallet/ > **Deprecated** > The Bayarcash wallet is deprecated. Bayarcash now deducts its fees from each transaction before it pays out to your bank account. You do not need a wallet balance. This page stays only as a record. See [Payouts](/payouts/). Your Bayarcash wallet holds your account balance. Every time you receive a payment through Bayarcash, we deduct the transaction fee from your wallet. You must keep enough balance in your wallet to cover these fees, or payments will fail. ## How your wallet works The wallet balance decreases each time a transaction fee is charged. You can refill it whenever you need to. There are two ways to manage your wallet: 1. **Manual reload** - You top up the wallet yourself whenever the balance runs low. 2. **Auto-reload** - The system automatically tops up your wallet when the balance reaches zero or goes below it, by taking money from your daily collection. The minimum auto-reload amount is RM5.00. Which method you use, your wallet is ready to charge fees for every payment your customers make. ## Tips **Set up auto-reload if you process many payments.** Auto-reload keeps your wallet topped up automatically and prevents payment failures due to low balance. You control the minimum amount the system tops up, so you decide when it refills. **Check your wallet balance daily.** Open the **Wallet** section in your dashboard to see your current balance and top-up history. You can also download receipts of wallet reloads for your records. --- # Top up your wallet (deprecated) > Deprecated. How merchants topped up the old Bayarcash wallet, kept as a record. > > Source: https://docs.bayarcash.com/top-up-wallet/ > **Deprecated** > The Bayarcash wallet is deprecated. Bayarcash now deducts its fees from each transaction before it pays out to your bank account. You do not need a wallet balance. This page stays only as a record. See [Payouts](/payouts/). Top up your wallet to pay for transaction fees. The minimum top-up is RM100. ## Top up the wallet 1. Open the merchant dashboard and go to the dashboard. 2. Click the **Reload** button at the top right. 3. Fill in the amount to reload. 4. Click **Next**. 5. Choose your bank from the list of available payment channels. The page redirects to your bank's login. 6. Complete the payment in your bank's app or website. When the payment succeeds, your wallet balance updates within seconds. You can now use the balance to pay for transaction fees on future payments. ## Tips **Save time with auto-reload.** If you want your wallet to top up automatically when the balance runs low, turn on auto-reload in your **Wallet** settings. See [Your Bayarcash wallet](/wallet/) for details. **Always keep a buffer.** Top up before your balance gets too low. This prevents payment failures if you receive many payments in a short time. --- # Download wallet receipts (deprecated) > Deprecated. How merchants downloaded receipts for the old Bayarcash wallet, kept as a record. > > Source: https://docs.bayarcash.com/wallet-receipt/ > **Deprecated** > The Bayarcash wallet is deprecated. Bayarcash now deducts its fees from each transaction before it pays out to your bank account. You do not need a wallet balance. This page stays only as a record. See [Payouts](/payouts/). Download receipts for your wallet reloads and automatic top-ups. These receipts are useful for your records and accounting. ## Download a wallet receipt 1. Open the merchant dashboard and go to the dashboard. 2. Click **Tools** at the top right. 3. Click **Download Receipt**. 4. The **Wallet Auto Reload Receipt** window opens. You can view or download your wallet transactions. 5. To view a specific transaction, click the transaction row to see details. 6. To download all receipts, click the **Download** button. The file downloads as a spreadsheet or PDF (depending on your browser and settings). You can open it in Excel, Google Sheets or any spreadsheet app. ## Tips **Keep receipts for reconciliation.** Download receipts regularly to match your wallet top-ups with your bank statements and accounting records. **Check for auto-reload transactions.** If you have auto-reload enabled, both manual top-ups and automatic reloads appear in the receipt. --- # Direct Debit or card auto debit: which one to use > Bayarcash collects recurring payments by Direct Debit. Cards take one-off payments only. Compare the two and pick the right one. > > Source: https://docs.bayarcash.com/direct-debit-vs-card/ Bayarcash collects recurring payments by Direct Debit only. The customer uses FPX only to approve, change or end the e-Mandate. The deductions do not use FPX. Card payments with Bayarcash are one-off payments: Bayarcash does not keep a card to charge it again later. This page compares Direct Debit and card auto debit, so that you can choose the correct method. ## What each one does The two methods move money in different ways: | | Direct Debit | Card auto debit | |---|---|---| | **Who runs it** | PayNet, through the customer's bank | The card network (Visa or Mastercard) and the bank that issued the card | | **How the customer agrees** | One time: the customer approves an e-Mandate by FPX in their online banking, then the bank approves it | The first payment with an OTP (3-D Secure), and an agreement that the merchant can charge the card again | | **Accounts** | Current, savings and credit card accounts at participating banks. Not debit cards | Credit and debit cards | | **Amount and frequency** | Set in the e-Mandate: weekly (on Friday), monthly or yearly. RM 5.00 to RM 30,000.00 for each deduction | Set in the agreement with the customer. The amount can change if the agreement says so | | **Approval of each charge** | No new approval. Each deduction follows the e-Mandate | The card bank approves or declines each charge | | **Why a charge can fail** | Not enough money or credit limit in the account, or the e-Mandate is not active | The card expired or was replaced, no credit limit or money left, or the bank declined the charge | | **How to cancel** | The customer ends the e-Mandate. See [Change or end a Direct Debit](/direct-debit-maintenance-termination/) | The customer tells the merchant, or asks the card bank to stop the charges | | **Disputes** | The customer contacts their bank | The customer can dispute a charge with the card bank, for a limited time | | **Fees** | A fixed fee for each enrolment, change and deduction. See the [Payout calculator](/payout-calculator/) | Usually a percentage of each charge | | **On Bayarcash** | Yes | No. Bayarcash cards take one-off payments only | > **Note** > DuitNow AutoDebit is a different PayNet product. Bayarcash does not offer it. ## When to use Direct Debit Use Direct Debit for a payment that repeats on a fixed schedule: - Subscriptions, memberships and course fees, every week, month or year. - Recurring donations. - Instalments with the same amount each time. The customer approves once, and the deductions continue until the e-Mandate ends. ## When to use a card or another one-off channel Use a card, FPX or DuitNow for a payment that happens one time: - A single purchase or a single donation. - A payment with an amount that changes each time. - A customer who does not want an e-Mandate. You can send the customer a new payment link for each payment. See [Payment channels](/payment-channels/). ## What your customer does The steps for your customer are different for each method. ### With Direct Debit 1. Your customer opens the enrolment page from your shop or from your link, and chooses their bank. 2. They sign in to their online banking and approve the e-Mandate. The bank takes RM1.00 from the account. Bayarcash does not refund it. 3. The bank checks and approves the e-Mandate. At Bayarcash, this usually takes 3 to 5 days. 4. The deductions start on the schedule. Your customer does nothing more for each deduction. ### With a card 1. Your customer types their card details on the Bayarcash payment page. 2. They confirm the payment with the OTP from their bank. 3. For the next payment, they pay again in the same way. ## Set up recurring payments Bayarcash gives you these ways to start Direct Debit: - **One customer at a time:** in the merchant dashboard, open **Transactions**, then **e-Mandates**, then **New Enrollment**. See [Enrol a customer in Direct Debit](/direct-debit-enrollment/). - **A WooCommerce shop:** use **Bayarcash Direct Debit** with WooCommerce Subscriptions. See [WooCommerce](/woocommerce/). - **GiveWP donations:** use the GiveWP Recurring Donations add-on. See [GiveWP](/givewp/). - **Your own system:** use the Direct Debit API. See [Developers](/developers/). ## Tips - **Tell your customer the schedule.** Say the amount and the day of each deduction before they approve the e-Mandate. - **Watch the first deduction.** Check [Direct Debit transactions](/direct-debit-transactions/) after the first deduction date, then follow up on any failure. ## Common issues ### Can Bayarcash charge my customer's card every month? No. Bayarcash takes card payments one at a time, and it does not keep cards for later charges. For a payment every week, month or year, use Direct Debit. See Enrol a customer in Direct Debit (/direct-debit-enrollment/). ### Which is cheaper for a subscription? Direct Debit has a fixed fee for each deduction. A card payment usually has a fee that is a percentage of the amount. For the Bayarcash fees, see the Payout calculator (/payout-calculator/). ### Can I take daily payments by Direct Debit? No. Bayarcash offers Direct Debit every week, every month or every year. A weekly deduction is on a Friday. See When Direct Debit deductions happen (/direct-debit-deduction-schedule/). --- # Direct Debit atau auto debit kad: mana satu patut anda guna > Bayarcash memungut bayaran berulang melalui Direct Debit. Kad hanya untuk bayaran sekali sahaja. Bandingkan kedua-duanya dan pilih yang sesuai. > > Source: https://docs.bayarcash.com/ms/direct-debit-vs-card/ Bayarcash memungut bayaran berulang melalui Direct Debit sahaja. Pelanggan hanya menggunakan FPX untuk meluluskan, menukar atau menamatkan e-Mandate. Potongan tidak menggunakan FPX. Bayaran kad dengan Bayarcash ialah bayaran sekali sahaja: Bayarcash tidak menyimpan kad untuk dicaj semula kemudian. Page ini membandingkan Direct Debit dengan auto debit kad, supaya anda boleh memilih kaedah yang betul. ## Beza kedua-dua kaedah Kedua-dua kaedah ini memindahkan wang dengan cara yang berbeza: | | Direct Debit | Auto debit kad | |---|---|---| | **Siapa yang menguruskannya** | PayNet, melalui bank pelanggan | Rangkaian kad (Visa atau Mastercard) dan bank yang mengeluarkan kad itu | | **Cara pelanggan bersetuju** | Sekali sahaja: pelanggan meluluskan e-Mandate melalui FPX dalam online banking mereka, kemudian bank meluluskannya | Bayaran pertama dengan OTP (3-D Secure), dan persetujuan bahawa merchant boleh caj kad itu lagi | | **Akaun** | Akaun semasa, akaun simpanan dan akaun kad kredit di bank yang mengambil bahagian. Bukan kad debit | Kad kredit dan kad debit | | **Amaun dan kekerapan** | Ditetapkan dalam e-Mandate: mingguan (pada hari Jumaat), bulanan atau tahunan. RM 5.00 hingga RM 30,000.00 bagi setiap potongan | Ditetapkan dalam perjanjian dengan pelanggan. Amaun boleh berubah jika perjanjian itu membenarkannya | | **Kelulusan setiap caj** | Tiada kelulusan baru. Setiap potongan mengikut e-Mandate | Bank kad meluluskan atau menolak setiap caj | | **Sebab caj boleh gagal** | Wang atau had kredit dalam akaun tidak cukup, atau e-Mandate tidak aktif | Kad sudah tamat tempoh atau sudah diganti, had kredit atau wang sudah habis, atau bank menolak caj itu | | **Cara membatalkan** | Pelanggan menamatkan e-Mandate. Lihat [Tukar atau tamatkan Direct Debit](/ms/direct-debit-maintenance-termination/) | Pelanggan memberitahu merchant, atau meminta bank kad menghentikan caj itu | | **Pertikaian** | Pelanggan menghubungi bank mereka | Pelanggan boleh mempertikaikan caj dengan bank kad, dalam tempoh yang terhad | | **Caj** | Caj tetap untuk setiap enrolment, perubahan dan potongan. Lihat [Kalkulator payout](/ms/payout-calculator/) | Biasanya peratusan daripada setiap caj | | **Dalam Bayarcash** | Ya | Tidak. Kad Bayarcash hanya untuk bayaran sekali sahaja | > **Note** > DuitNow AutoDebit ialah produk PayNet yang lain. Bayarcash tidak menawarkannya. ## Bila perlu guna Direct Debit Guna Direct Debit untuk bayaran yang berulang mengikut jadual tetap: - Langganan, keahlian dan yuran kursus, setiap minggu, bulan atau tahun. - Derma berulang. - Ansuran dengan amaun yang sama setiap kali. Pelanggan meluluskan sekali sahaja, dan potongan berterusan sehingga e-Mandate itu tamat. ## Bila perlu guna kad atau saluran sekali bayar yang lain Guna kad, FPX atau DuitNow untuk bayaran yang berlaku sekali sahaja: - Satu pembelian atau satu derma. - Bayaran dengan amaun yang berubah setiap kali. - Pelanggan yang tidak mahu e-Mandate. Anda boleh menghantar payment link baru kepada pelanggan untuk setiap bayaran. Lihat [Saluran bayaran yang boleh anda terima melalui Bayarcash](/ms/payment-channels/). ## Apa yang pelanggan anda buat Langkah untuk pelanggan anda berbeza bagi setiap kaedah. ### Dengan Direct Debit 1. Pelanggan anda membuka page enrolment dari kedai atau link anda, dan memilih bank mereka. 2. Pelanggan log masuk ke online banking mereka dan meluluskan e-Mandate itu. Bank memotong RM1.00 dari akaun itu. Bayarcash tidak refund jumlah ini. 3. Bank menyemak dan meluluskan e-Mandate itu. Di Bayarcash, ini biasanya mengambil masa 3 hingga 5 hari. 4. Potongan bermula mengikut jadual. Pelanggan anda tidak perlu buat apa-apa lagi untuk setiap potongan. ### Dengan kad 1. Pelanggan anda menaip butiran kad mereka di page bayaran Bayarcash. 2. Pelanggan mengesahkan bayaran itu dengan OTP daripada bank mereka. 3. Untuk bayaran seterusnya, pelanggan membayar semula dengan cara yang sama. ## Sediakan bayaran berulang Bayarcash memberi anda cara ini untuk memulakan Direct Debit: - **Seorang pelanggan pada satu masa:** dalam merchant dashboard, buka **Transactions**, kemudian **e-Mandates**, kemudian **New Enrollment**. Lihat [Daftarkan pelanggan dalam Direct Debit dari merchant dashboard](/ms/direct-debit-enrollment/). - **Kedai WooCommerce:** guna **Bayarcash Direct Debit** dengan WooCommerce Subscriptions. Lihat [Sambungkan WooCommerce kepada Bayarcash](/ms/woocommerce/). - **Derma GiveWP:** guna add-on GiveWP Recurring Donations. Lihat [Sambungkan GiveWP kepada Bayarcash](/ms/givewp/). - **Sistem anda sendiri:** guna API Direct Debit. Lihat [Bina integrasi dengan API Bayarcash](/ms/developers/). ## Tips - **Beritahu pelanggan anda tentang jadual itu.** Nyatakan amaun dan hari setiap potongan sebelum pelanggan meluluskan e-Mandate. - **Pantau potongan pertama.** Semak [transaksi Direct Debit](/ms/direct-debit-transactions/) selepas tarikh potongan pertama, kemudian buat follow-up untuk setiap potongan yang gagal. ## Isu biasa ### Bolehkah Bayarcash caj kad pelanggan saya setiap bulan? Tidak boleh. Bayarcash menerima bayaran kad satu demi satu, dan tidak menyimpan kad untuk dicaj kemudian. Untuk bayaran setiap minggu, bulan atau tahun, guna Direct Debit. Lihat Daftarkan pelanggan dalam Direct Debit dari merchant dashboard (/ms/direct-debit-enrollment/). ### Yang mana lebih murah untuk langganan? Direct Debit ada caj tetap untuk setiap potongan. Bayaran kad biasanya ada caj dalam bentuk peratusan daripada amaun. Untuk caj Bayarcash, lihat Kalkulator payout (/ms/payout-calculator/). ### Bolehkah saya terima bayaran harian melalui Direct Debit? Tidak boleh. Bayarcash menawarkan Direct Debit setiap minggu, setiap bulan atau setiap tahun. Potongan mingguan dibuat pada hari Jumaat. Lihat Bila potongan Direct Debit berlaku (/ms/direct-debit-deduction-schedule/). --- # Direct Debit还是卡自动扣款:该用哪一种 > Bayarcash用Direct Debit收取定期付款,卡只用于一次性付款。比较两者,选择合适的方法。 > > Source: https://docs.bayarcash.com/zh/direct-debit-vs-card/ Bayarcash只用Direct Debit收取定期付款。顾客只在批准、修改或终止e-Mandate时使用FPX,扣款不使用FPX。Bayarcash的卡付款是一次性付款:Bayarcash不会保存卡以便日后再次扣款。这个页面比较Direct Debit和卡自动扣款,让你选择正确的方法。 ## 两者的作用 这两种方法转移款项的方式不同: | | Direct Debit | 卡自动扣款 | |---|---|---| | **由谁运作** | PayNet,通过顾客的银行 | 卡组织(Visa或Mastercard)和发卡银行 | | **顾客如何同意** | 只需一次:顾客通过FPX在网上银行批准e-Mandate,然后银行批准它 | 第一次付款用OTP(3-D Secure)确认,并同意商家可以再次从卡扣款 | | **账户** | 参与银行的往来账户、储蓄账户和信用卡账户。不包括借记卡 | 信用卡和借记卡 | | **金额和频率** | 在e-Mandate中设定:每周(星期五)、每月或每年。每次扣款RM 5.00至RM 30,000.00 | 在与顾客的协议中设定。如果协议允许,金额可以改变 | | **每次扣款的批准** | 不需要再批准。每次扣款都按照e-Mandate | 发卡银行批准或拒绝每次扣款 | | **扣款失败的原因** | 账户余额或信用额度不足,或e-Mandate不是有效状态 | 卡已过期或已更换,信用额度或余额用完,或银行拒绝了扣款 | | **如何取消** | 顾客终止e-Mandate。请看[修改或终止Direct Debit](/zh/direct-debit-maintenance-termination/) | 顾客通知商家,或要求发卡银行停止扣款 | | **争议** | 顾客联系自己的银行 | 顾客可以在有限时间内向发卡银行提出争议 | | **手续费** | 每次登记、修改和扣款都收取固定手续费。请看[Payout计算器](/zh/payout-calculator/) | 通常是每次扣款金额的某个百分比 | | **Bayarcash是否提供** | 是 | 否。Bayarcash的卡只用于一次性付款 | > **Note** > DuitNow AutoDebit是PayNet的另一个产品。Bayarcash不提供它。 ## 什么时候用Direct Debit 按固定时间表重复的付款,用Direct Debit: - 每周、每月或每年的订阅、会员费和课程费。 - 定期捐款。 - 每次金额相同的分期付款。 顾客只需批准一次,扣款会持续到e-Mandate结束为止。 ## 什么时候用卡或其他一次性付款渠道 只付一次的款项,用卡、FPX或DuitNow: - 单次购买或单次捐款。 - 每次金额都不同的付款。 - 不想使用e-Mandate的顾客。 你可以为每次付款发送新的付款链接给顾客。请看[你可以通过Bayarcash接受的付款渠道](/zh/payment-channels/)。 ## 你的顾客要做什么 每种方法中,顾客的步骤都不同。 ### 使用Direct Debit 1. 你的顾客从你的网店或你的链接打开登记页面,然后选择自己的银行。 2. 他们登录网上银行,批准e-Mandate。银行会从账户扣除RM1.00,Bayarcash不会退还。 3. 银行检查并批准e-Mandate。在Bayarcash,这通常需要3到5天。 4. 扣款按时间表开始。每次扣款时,顾客都不需要再做任何事。 ### 使用卡 1. 你的顾客在Bayarcash付款页面输入卡资料。 2. 他们用银行发送的OTP确认付款。 3. 下一次付款时,他们用同样的方式再付一次。 ## 设置定期付款 Bayarcash提供以下方法开始Direct Debit: - **一次一位顾客**:在商家后台(merchant dashboard)中,打开**Transactions**,然后**e-Mandates**,再选择**New Enrollment**。请看[从商家后台为顾客登记Direct Debit](/zh/direct-debit-enrollment/)。 - **WooCommerce网店**:把**Bayarcash Direct Debit**和WooCommerce Subscriptions一起使用。请看[把WooCommerce连接到Bayarcash](/zh/woocommerce/)。 - **GiveWP捐款**:使用GiveWP Recurring Donations附加服务(add-on)。请看[把GiveWP连接到Bayarcash](/zh/givewp/)。 - **你自己的系统**:使用Direct Debit API。请看[Bayarcash API文档和sandbox](/zh/developers/)。 ## 小贴士 - **告诉顾客扣款时间表**。在顾客批准e-Mandate之前,说明每次扣款的金额和日期。 - **留意第一次扣款**。在第一次扣款日期之后查看[Direct Debit交易](/zh/direct-debit-transactions/),如有失败就跟进。 ## 常见问题 ### Bayarcash可以每个月从我顾客的卡扣款吗? 不可以。Bayarcash的卡付款是一次一笔,不会保存卡以便日后扣款。每周、每月或每年的付款,请用Direct Debit。请看从商家后台为顾客登记Direct Debit (/zh/direct-debit-enrollment/)。 ### 订阅用哪一种比较便宜? Direct Debit每次扣款收取固定手续费。卡付款的手续费通常是金额的某个百分比。Bayarcash的手续费请看Payout计算器 (/zh/payout-calculator/)。 ### 我可以用Direct Debit每天收款吗? 不可以。Bayarcash提供每周、每月或每年的Direct Debit。每周扣款在星期五进行。请看Direct Debit何时扣款 (/zh/direct-debit-deduction-schedule/)。 --- # Check your Direct Debit transactions > See every Direct Debit payment and enrolment made through your Bayarcash account, from the Transaction menu in the merchant dashboard. > > Source: https://docs.bayarcash.com/direct-debit-transactions/ Direct Debit payments have their own list in the merchant dashboard. Use it to see the enrolments and every deduction processed for your account. ## Open the Direct Debit transaction list Do this when you want to check one customer's recurring payment, or review recent deductions. 1. Sign in to the merchant dashboard. See [Sign in](/sign-in/). 2. Select **Transactions** in the menu at the top left of the dashboard. 3. In the drop-down, under **Direct Debit**, select **Transactions**. *(Screenshot: The Transactions menu open with Transactions under Direct Debit highlighted)* 4. The page lists every Direct Debit transaction made through your account. *(Screenshot: The Direct Debit Transactions page with the Unsuccessful and Successful totals and the list columns)* ## What the list contains The list holds two kinds of rows: the application to set up the Direct Debit (the enrolment) and each deduction that follows. Each row has a status. | Status | What it means | |---|---| | New | Created, not started yet. | | Pending | Waiting for the bank. | | Unsuccessful | The bank did not approve or could not collect. | | Successful | The bank approved or collected the money. | | Cancelled | Stopped before it finished. | | Abandoned | The customer left before completing it. | To check the agreement itself (whether it is active or terminated), use the [e-Mandate list](/e-mandates/). ## Why a deduction fails When the bank of your customer rejects a deduction, it gives one of these reasons: | Reason from the bank | What it means | What to do | |---|---|---| | Account error | There is a problem with the account of your customer. | Ask your customer to check the account with their bank. | | Refer to drawer | The bank did not pay. Usually the account does not have enough money. | Ask your customer to put money in the account. | | Account not registered | The account has no active e-Mandate at the bank. | Check the e-Mandate in the [e-Mandate list](/e-mandates/). | | Exceeded maximum amount | The deduction is more than the amount in the e-Mandate. | Ask your customer to change the amount. See [Change or end a Direct Debit](/direct-debit-maintenance-termination/). | | Exceeded number of deductions | The deduction is more than the number of deductions that the e-Mandate allows. | Contact Bayarcash support. | | Duplicate record | The same deduction came 2 times. | Contact Bayarcash support. | | System error, seller error or others | A different problem. | Contact Bayarcash support. | ## For developers Developers can list and filter Direct Debit transactions through the API instead of the merchant dashboard. See [Developers](/developers/) and the [API reference](https://api-reference.bayarcash.com). ## Common issues ### I cannot find a customer's monthly deduction. Where do I look? Open Direct Debit Transaction, not the FPX list. Every Direct Debit enrolment and deduction is listed there. ### A deduction shows as unsuccessful. Will Bayarcash try again? A failed first monthly deduction gets one retry in the same month. See When Direct Debit deductions happen (/direct-debit-deduction-schedule/) for the dates. ### Can I get this list through the API? Yes. The API returns Direct Debit transactions with filters such as status and order number. See the API reference (https://api-reference.bayarcash.com) and Developers (/developers/). --- # Semak transaksi Direct Debit anda > Lihat setiap bayaran dan enrolment Direct Debit melalui akaun Bayarcash anda, dari menu Transactions dalam merchant dashboard. > > Source: https://docs.bayarcash.com/ms/direct-debit-transactions/ Bayaran Direct Debit ada senarai sendiri dalam merchant dashboard. Guna senarai ini untuk melihat enrolment dan setiap potongan yang diproses untuk akaun anda. ## Buka senarai transaksi Direct Debit Buat langkah ini apabila anda mahu menyemak bayaran berulang seorang pelanggan, atau melihat potongan terkini. 1. Log masuk ke merchant dashboard. Lihat [Log masuk ke merchant dashboard](/ms/sign-in/). 2. Klik **Transactions** dalam menu di bahagian atas kiri dashboard. 3. Dalam menu drop-down, di bawah **Direct Debit**, klik **Transactions**. *(Screenshot: Menu Transactions dibuka, dengan Transactions di bawah Direct Debit ditanda)* 4. Page itu menyenaraikan setiap transaksi Direct Debit melalui akaun anda. *(Screenshot: Page Direct Debit Transactions dengan jumlah Unsuccessful dan Successful serta lajur senarai)* ## Apa yang ada dalam senarai Senarai ini ada dua jenis baris. Satu ialah permohonan untuk memulakan Direct Debit (enrolment). Satu lagi ialah setiap potongan selepas itu. Setiap baris ada status. | Status | Maksud | |---|---| | New | Sudah dibuat, tetapi belum bermula. | | Pending | Menunggu jawapan bank. | | Unsuccessful | Bank tidak meluluskan, atau bank tidak dapat memotong wang. | | Successful | Bank sudah meluluskan, atau bank sudah memotong wang. | | Cancelled | Dihentikan sebelum selesai. | | Abandoned | Pelanggan keluar sebelum selesai. | Untuk menyemak perjanjian itu sendiri (sama ada aktif atau sudah ditamatkan), guna [senarai e-Mandate](/ms/e-mandates/). ## Kenapa potongan gagal Apabila bank pelanggan anda menolak potongan, bank memberi salah satu sebab ini: | Sebab daripada bank | Maksudnya | Apa yang perlu dibuat | |---|---|---| | Account error | Ada masalah pada akaun pelanggan anda. | Minta pelanggan menyemak akaun itu dengan bank mereka. | | Refer to drawer | Bank tidak membayar. Biasanya baki akaun tidak cukup. | Minta pelanggan memasukkan wang ke dalam akaun itu. | | Account not registered | Akaun itu tiada e-Mandate yang aktif di bank. | Semak e-Mandate itu dalam [senarai e-Mandate](/ms/e-mandates/). | | Exceeded maximum amount | Potongan itu lebih daripada amaun dalam e-Mandate. | Minta pelanggan menukar amaun itu. Lihat [Tukar atau tamatkan Direct Debit](/ms/direct-debit-maintenance-termination/). | | Exceeded number of deductions | Bilangan potongan melebihi bilangan yang dibenarkan oleh e-Mandate. | Hubungi support Bayarcash. | | Duplicate record | Potongan yang sama dihantar 2 kali. | Hubungi support Bayarcash. | | System error, seller error or others | Masalah lain. | Hubungi support Bayarcash. | ## Untuk developer Developer boleh menyenaraikan dan filter transaksi Direct Debit melalui API, tanpa merchant dashboard. Lihat [Bina integrasi dengan API Bayarcash](/ms/developers/) dan [API reference](https://api-reference.bayarcash.com). ## Isu biasa ### Saya tidak jumpa potongan bulanan seorang pelanggan. Di mana saya perlu cari? Buka Direct Debit Transaction, bukan senarai FPX. Setiap enrolment dan potongan Direct Debit disenaraikan di situ. ### Satu potongan memaparkan status Unsuccessful. Adakah Bayarcash akan cuba sekali lagi? Jika potongan bulanan pertama gagal, potongan itu dicuba sekali lagi dalam bulan yang sama. Tarikhnya ada dalam Bila potongan Direct Debit berlaku (/ms/direct-debit-deduction-schedule/). ### Boleh saya dapatkan senarai ini melalui API? Boleh. API memberikan transaksi Direct Debit dengan filter seperti status dan nombor pesanan. Lihat API reference (https://api-reference.bayarcash.com) dan Bina integrasi dengan API Bayarcash (/ms/developers/). --- # 查看你的Direct Debit交易 > 在商家后台的Transactions菜单中,查看你Bayarcash账号的每笔Direct Debit付款和登记。 > > Source: https://docs.bayarcash.com/zh/direct-debit-transactions/ Direct Debit付款在商家后台(merchant dashboard)中有自己的列表。用它查看你账号的登记记录,以及每一笔已处理的扣款。 ## 打开Direct Debit交易列表 当你想查看某位顾客的定期付款,或查看最近的扣款时,就按以下步骤操作。 1. 登录商家后台。请看[登录商家后台](/zh/sign-in/)。 2. 在后台左上方的菜单中,选择**Transactions**。 3. 在下拉菜单中,在**Direct Debit**下选择**Transactions**。 *(Screenshot: Transactions菜单已打开,Direct Debit下的Transactions已标示)* 4. 页面会列出你账号的每一笔Direct Debit交易。 *(Screenshot: Direct Debit Transactions页面,显示Unsuccessful和Successful总数以及列表的各列)* ## 列表中有什么 列表中有两种记录:设置Direct Debit的申请(登记),以及之后的每一笔扣款。每条记录都有一个状态。 | 状态 | 意思 | |---|---| | New | 已创建,还没开始。 | | Pending | 正在等待银行。 | | Unsuccessful | 银行没有批准,或无法扣款。 | | Successful | 银行已批准,或已扣款。 | | Cancelled | 在完成前被停止。 | | Abandoned | 顾客在完成前离开了。 | 要查看协议本身(是有效还是已终止),请用[e-Mandate列表](/zh/e-mandates/)。 ## 扣款失败的原因 顾客的银行拒绝扣款时,会给出以下其中一个原因: | 银行给出的原因 | 意思 | 怎么做 | |---|---|---| | Account error | 顾客的账户有问题。 | 请顾客向银行查询这个账户。 | | Refer to drawer | 银行没有付款,通常是账户余额不足。 | 请顾客把钱存入账户。 | | Account not registered | 这个账户在银行没有有效的e-Mandate。 | 在[e-Mandate列表](/zh/e-mandates/)查看这个e-Mandate。 | | Exceeded maximum amount | 扣款金额超过e-Mandate里的金额。 | 请顾客修改金额。请看[修改或终止Direct Debit](/zh/direct-debit-maintenance-termination/)。 | | Exceeded number of deductions | 扣款次数超过e-Mandate允许的次数。 | 联系Bayarcash支持团队。 | | Duplicate record | 同一笔扣款发送了2次。 | 联系Bayarcash支持团队。 | | System error, seller error or others | 其他问题。 | 联系Bayarcash支持团队。 | ## 给开发者 开发者可以通过API列出和筛选Direct Debit交易,不必使用商家后台。请看[Bayarcash API文档和sandbox](/zh/developers/)和[API reference](https://api-reference.bayarcash.com)。 ## 常见问题 ### 我找不到某位顾客的每月扣款。应该去哪里找? 打开Direct Debit Transaction,不是FPX列表。每笔Direct Debit登记和扣款都列在那里。 ### 一笔扣款显示不成功。Bayarcash会再试一次吗? 如果第一次每月扣款失败,会在同一个月内再试一次。日期请看Direct Debit何时扣款 (/zh/direct-debit-deduction-schedule/)。 ### 我可以通过API取得这个列表吗? 可以。API会返回Direct Debit交易,并提供状态和订单号码等筛选条件。请看API reference (https://api-reference.bayarcash.com)和Bayarcash API文档和sandbox (/zh/developers/)。 --- # Check your Direct Debit e-Mandates > See the list of Direct Debit e-Mandates made through your account and use the e-mandate checker to look up the status of one. > > Source: https://docs.bayarcash.com/e-mandates/ An e-Mandate is your customer's electronic approval for you to collect money from their bank account on a schedule. The account can be a current, savings or credit card account. The e-Mandate list in the merchant dashboard shows every one made through your account, and the **e-mandate checker** looks up the status of one. ## Open the e-Mandate list Do this to see all your customers' e-Mandates in one place. 1. Sign in to the merchant dashboard. See [Sign in](/sign-in/). 2. Select **Transactions** in the menu at the top left of the dashboard. 3. In the drop-down, under **Direct Debit**, select **e-Mandates**. *(Screenshot: The Transactions menu open with e-Mandates under Direct Debit highlighted)* 4. The page lists every Direct Debit e-Mandate made through your account. *(Screenshot: The Direct Debit e-Mandates page with sample e-Mandates)* ## Check the status of an e-Mandate Use the checker when a customer asks whether their e-Mandate is active. 1. On the e-Mandates list, select the **e-mandate checker** button. 2. Follow the screen to look up the e-Mandate. ## e-Mandate statuses An e-Mandate moves through these statuses. | Status | What it means | |---|---| | New | Created, the customer has not finished yet. | | Waiting Approval | Sent to the bank, waiting for its answer. | | Failed Bank Authorization | The bank did not authorise it. | | Active | Approved. Deductions can run. | | Terminated | Ended. No more deductions. | | Rejected | The bank rejected the application. | | Cancelled | Cancelled before it became active. | To end an e-Mandate, see [Change or end a Direct Debit](/direct-debit-maintenance-termination/). To see the payments collected, see [Direct Debit transactions](/direct-debit-transactions/). ## The e-Mandate page for your customers Your customers can use the Bayarcash mandate page at [mandate.bayarcash.com](https://mandate.bayarcash.com/) without an account. The old address, mandate.bayar.cash, opens the same page. - To check the status of an e-Mandate, they type the **Payment Reference Number** and their **Email**, then choose **Check Mandate**. See [Check an e-Mandate](/public-checkers/#check-an-e-mandate). - To end an e-Mandate, see [End it on the Bayarcash mandate page](/direct-debit-maintenance-termination/#end-it-on-the-bayarcash-mandate-page). Give your customers this address if they ask where to check or end their Direct Debit. ## For developers The API can enrol, list, change and terminate e-Mandates. See [Developers](/developers/) and the [API reference](https://api-reference.bayarcash.com). ## Common issues ### My customer says they approved the e-Mandate, but I see Waiting Approval. The bank can take several days to confirm. Bayarcash updates the status when the bank replies. See When Direct Debit deductions happen (/direct-debit-deduction-schedule/). ### What does Failed Bank Authorization mean? The customer's bank did not authorise the e-Mandate. Ask the customer to start a new enrolment. ### Do I set up recurring payments for WooCommerce or GiveWP here? No. Recurring payments are set up in the plugin. See WooCommerce (/woocommerce/) and GiveWP (/givewp/). This page is for checking e-Mandates afterwards. ### What is mandate.bayar.cash? It is the old address of the Bayarcash mandate page. It now opens mandate.bayarcash.com (https://mandate.bayarcash.com/), where customers check or end an e-Mandate. See The e-Mandate page for your customers (#the-e-mandate-page-for-your-customers). --- # Semak e-Mandate Direct Debit anda > Lihat senarai e-Mandate Direct Debit melalui akaun anda, dan guna e-mandate checker untuk menyemak status satu e-Mandate. > > Source: https://docs.bayarcash.com/ms/e-mandates/ E-Mandate ialah kebenaran elektronik daripada pelanggan anda. Dengan kebenaran ini, anda boleh memotong wang dari akaun bank mereka mengikut jadual. Akaun itu boleh jadi akaun semasa, akaun simpanan atau akaun kad kredit. Senarai e-Mandate dalam merchant dashboard memaparkan setiap e-Mandate melalui akaun anda. Butang **e-mandate checker** menyemak status satu e-Mandate. ## Buka senarai e-Mandate Buat langkah ini untuk melihat semua e-Mandate pelanggan anda di satu tempat. 1. Log masuk ke merchant dashboard. Lihat [Log masuk ke merchant dashboard](/ms/sign-in/). 2. Klik **Transactions** dalam menu di bahagian atas kiri dashboard. 3. Dalam menu drop-down, di bawah **Direct Debit**, klik **e-Mandates**. *(Screenshot: Menu Transactions dibuka, dengan e-Mandates di bawah Direct Debit ditanda)* 4. Page itu menyenaraikan setiap e-Mandate Direct Debit melalui akaun anda. *(Screenshot: Page Direct Debit e-Mandates dengan contoh e-Mandate)* ## Semak status e-Mandate Guna checker ini apabila pelanggan bertanya sama ada e-Mandate mereka sudah aktif. 1. Pada senarai e-Mandates, klik butang **e-mandate checker**. 2. Ikut arahan pada skrin untuk mencari e-Mandate itu. ## Status e-Mandate Setiap e-Mandate melalui status ini. | Status | Maksud | |---|---| | New | Sudah dibuat, tetapi pelanggan belum selesai. | | Waiting Approval | Sudah dihantar ke bank, dan menunggu jawapan bank. | | Failed Bank Authorization | Bank tidak meluluskannya. | | Active | Sudah diluluskan. Potongan boleh berjalan. | | Terminated | Sudah ditamatkan. Tiada potongan lagi. | | Rejected | Bank menolak permohonan itu. | | Cancelled | Dibatalkan sebelum menjadi aktif. | Untuk menamatkan e-Mandate, lihat [Tukar atau tamatkan Direct Debit](/ms/direct-debit-maintenance-termination/). Untuk melihat bayaran yang sudah dipotong, lihat [Semak transaksi Direct Debit anda](/ms/direct-debit-transactions/). ## Page e-Mandate untuk pelanggan anda Pelanggan anda boleh guna page mandate Bayarcash di [mandate.bayarcash.com](https://mandate.bayarcash.com/) tanpa akaun. Alamat lama, mandate.bayar.cash, membuka page yang sama. - Untuk menyemak status e-Mandate, pelanggan taip **Payment Reference Number** dan **Email** mereka, kemudian klik **Check Mandate**. Lihat [Semak e-Mandate](/ms/public-checkers/#semak-e-mandate). - Untuk menamatkan e-Mandate, lihat [Tamatkan di page mandate Bayarcash](/ms/direct-debit-maintenance-termination/#tamatkan-di-page-mandate-bayarcash). Berikan alamat ini kepada pelanggan anda jika mereka bertanya di mana mereka boleh menyemak atau menamatkan Direct Debit. ## Untuk developer API boleh membuat enrolment, menyenaraikan, menukar dan menamatkan e-Mandate. Lihat [Bina integrasi dengan API Bayarcash](/ms/developers/) dan [API reference](https://api-reference.bayarcash.com). ## Isu biasa ### Pelanggan saya kata mereka sudah meluluskan e-Mandate, tetapi saya nampak Waiting Approval. Kenapa? Bank boleh mengambil masa beberapa hari untuk mengesahkannya. Bayarcash mengemas kini status itu apabila bank memberi jawapan. Lihat Bila potongan Direct Debit berlaku (/ms/direct-debit-deduction-schedule/). ### Apa maksud Failed Bank Authorization? Bank pelanggan tidak meluluskan e-Mandate itu. Minta pelanggan membuat enrolment baru. ### Adakah saya tetapkan bayaran berulang untuk WooCommerce atau GiveWP di sini? Tidak. Bayaran berulang ditetapkan dalam plugin. Lihat Sambungkan WooCommerce kepada Bayarcash (/ms/woocommerce/) dan Sambungkan GiveWP kepada Bayarcash (/ms/givewp/). Page ini hanya untuk menyemak e-Mandate selepas itu. ### Apa itu mandate.bayar.cash? Itu alamat lama page mandate Bayarcash. Alamat itu kini membuka mandate.bayarcash.com (https://mandate.bayarcash.com/). Di page itu, pelanggan boleh menyemak atau menamatkan e-Mandate. Lihat Page e-Mandate untuk pelanggan anda (#page-e-mandate-untuk-pelanggan-anda). --- # 查看你的Direct Debit e-Mandate > 查看通过你账号创建的Direct Debit e-Mandate列表,并用e-mandate checker查询它们的状态。 > > Source: https://docs.bayarcash.com/zh/e-mandates/ e-Mandate是顾客以电子方式给你的授权,让你按时间表从他们的银行账户收款。这个账户可以是往来账户、储蓄账户或信用卡账户。商家后台(merchant dashboard)里的e-Mandate列表显示通过你账号创建的每一个e-Mandate,而**e-mandate checker**可以查询其中一个的状态。 ## 打开e-Mandate列表 用这个方法在同一个地方查看所有顾客的e-Mandate。 1. 登录商家后台。请看[登录](/zh/sign-in/)。 2. 在商家后台左上方的菜单点击**Transactions**。 3. 在下拉菜单的**Direct Debit**下,点击**e-Mandates**。 *(Screenshot: Transactions菜单已打开,Direct Debit下的e-Mandates已标示)* 4. 页面会列出通过你账号创建的每一个Direct Debit e-Mandate。 *(Screenshot: Direct Debit e-Mandates页面,显示示例e-Mandate)* ## 查询e-Mandate的状态 顾客询问他们的e-Mandate是否已生效时,使用查询工具。 1. 在e-Mandates列表,点击**e-mandate checker**按钮。 2. 按照屏幕上的指示查询该e-Mandate。 ## e-Mandate状态 e-Mandate会经过以下状态。 | 状态 | 意思 | |---|---| | New | 已创建,顾客还没完成。 | | Waiting Approval | 已发送到银行,正在等待银行回复。 | | Failed Bank Authorization | 银行没有授权。 | | Active | 已批准。可以进行扣款。 | | Terminated | 已终止。不再扣款。 | | Rejected | 银行拒绝了申请。 | | Cancelled | 在生效前已取消。 | 要终止e-Mandate,请看[修改或终止Direct Debit](/zh/direct-debit-maintenance-termination/)。要查看已收取的付款,请看[Direct Debit交易](/zh/direct-debit-transactions/)。 ## 给顾客的e-Mandate页面 你的顾客不需要账号,就能使用[mandate.bayarcash.com](https://mandate.bayarcash.com/)的Bayarcash mandate页面。旧地址mandate.bayar.cash会打开同一个页面。 - 要查询e-Mandate的状态,他们输入**Payment Reference Number**和他们的**Email**,然后点击**Check Mandate**。请看[查询e-Mandate](/zh/public-checkers/#查询e-mandate)。 - 要终止e-Mandate,请看[在Bayarcash mandate页面终止](/zh/direct-debit-maintenance-termination/#在bayarcash-mandate页面终止)。 如果顾客问在哪里查询或终止他们的Direct Debit,就把这个地址给他们。 ## 给开发者 API可以登记、列出、修改和终止e-Mandate。请看[开发者](/zh/developers/)和[API参考文档](https://api-reference.bayarcash.com)。 ## 常见问题 ### 我的顾客说已经批准了e-Mandate,但我看到的是Waiting Approval。 银行可能需要几天才确认。银行回复后,Bayarcash会更新状态。请看Direct Debit何时扣款 (/zh/direct-debit-deduction-schedule/)。 ### Failed Bank Authorization是什么意思? 顾客的银行没有授权这个e-Mandate。请顾客重新登记。 ### WooCommerce或GiveWP的定期付款是在这里设置吗? 不是。定期付款在插件里设置。请看WooCommerce (/zh/woocommerce/)和GiveWP (/zh/givewp/)。这个页面是用来在之后查看e-Mandate的。 ### mandate.bayar.cash是什么? 这是Bayarcash mandate页面的旧地址。它现在会打开mandate.bayarcash.com (https://mandate.bayarcash.com/),顾客可以在那里查询或终止e-Mandate。请看给顾客的e-Mandate页面 (#给顾客的e-mandate页面)。 --- # When Direct Debit deductions happen > How weekly, monthly and yearly Direct Debit works from enrolment to each deduction, and when a failed monthly deduction is tried again. > > Source: https://docs.bayarcash.com/direct-debit-deduction-schedule/ Direct Debit collects money from your customer's bank account on a fixed rhythm: weekly, monthly or yearly. Bayarcash does not offer daily Direct Debit. Before the first deduction, the bank must approve the enrolment. ## Monthly Direct Debit Use this to know what happens to a customer who pays once a month. 1. Your customer applies to enrol in Direct Debit for monthly payments. 2. The application waits for the bank's approval. This usually takes 3 to 5 days. 3. Once approved, the enrolment is activated. 4. The first deduction is scheduled for the 3rd to the 5th of the month after the month of enrolment. 5. If the first deduction fails, it is tried once more between the 25th and 28th of that same month. ## Weekly Direct Debit Use this to know what happens to a customer who pays once a week. 1. Your customer applies to enrol in Direct Debit for weekly payments. 2. The application waits for the bank's approval. This usually takes 3 to 5 days. 3. Once approved, the enrolment is activated. 4. The first deduction is on a Friday, two weeks after the enrolment day. 5. After that, a deduction is made every Friday. ## Yearly Direct Debit A yearly Direct Debit makes one deduction each year. The bank must approve the enrolment first, the same as for weekly and monthly. The deduction date follows the e-Mandate. {/* TODO Hanny: yearly deduction day */} ## Follow each deduction Each enrolment and deduction appears in [Direct Debit transactions](/direct-debit-transactions/). The agreement itself is in the [e-Mandate list](/e-mandates/). > **Note** > If a date you see differs from the schedule above, contact Bayarcash support. ## Recurring payments in your shop If you sell subscriptions or recurring donations, the plugin sets Direct Debit up for your customer. See [WooCommerce](/woocommerce/) and [GiveWP](/givewp/). Developers can start an enrolment through the API: see [Developers](/developers/) and the [API reference](https://api-reference.bayarcash.com). ## Common issues ### My customer enrolled today. Why has nothing been deducted? The bank has to approve the enrolment first, which usually takes 3 to 5 days. The first deduction comes after that, on the dates below. ### A monthly deduction failed. Will it be tried again? Yes. A failed first monthly deduction is retried once, between the 25th and 28th of the same month. ### Which day are weekly deductions made? Every Friday. The first one is on the Friday two weeks after the enrolment day. --- # Bila potongan Direct Debit berlaku > Cara Direct Debit mingguan, bulanan dan tahunan berjalan, dari enrolment hingga setiap potongan, dan bila potongan bulanan yang gagal dicuba semula. > > Source: https://docs.bayarcash.com/ms/direct-debit-deduction-schedule/ Direct Debit memotong wang dari akaun bank pelanggan anda mengikut jadual tetap: mingguan, bulanan atau tahunan. Bayarcash tidak menawarkan Direct Debit harian. Sebelum potongan pertama, bank mesti meluluskan enrolment itu. ## Direct Debit bulanan Langkah ini menunjukkan apa yang berlaku kepada pelanggan yang membayar sebulan sekali. 1. Pelanggan anda memohon untuk mendaftar Direct Debit bagi bayaran bulanan. 2. Permohonan itu menunggu kelulusan bank. Ini biasanya mengambil masa 3 hingga 5 hari. 3. Selepas diluluskan, enrolment itu diaktifkan. 4. Potongan pertama dijadualkan pada 3 hingga 5 haribulan, pada bulan selepas bulan enrolment. 5. Jika potongan pertama gagal, potongan itu dicuba sekali lagi antara 25 hingga 28 haribulan pada bulan yang sama. ## Direct Debit mingguan Langkah ini menunjukkan apa yang berlaku kepada pelanggan yang membayar seminggu sekali. 1. Pelanggan anda memohon untuk mendaftar Direct Debit bagi bayaran mingguan. 2. Permohonan itu menunggu kelulusan bank. Ini biasanya mengambil masa 3 hingga 5 hari. 3. Selepas diluluskan, enrolment itu diaktifkan. 4. Potongan pertama berlaku pada hari Jumaat, dua minggu selepas hari enrolment. 5. Selepas itu, potongan dibuat setiap hari Jumaat. ## Direct Debit tahunan Direct Debit tahunan membuat satu potongan setiap tahun. Sama seperti mingguan dan bulanan, bank mesti meluluskan enrolment itu dahulu. Tarikh potongan mengikut e-Mandate. {/* TODO Hanny: yearly deduction day */} ## Ikuti setiap potongan Setiap enrolment dan potongan dipaparkan dalam [Semak transaksi Direct Debit anda](/ms/direct-debit-transactions/). Perjanjian itu sendiri ada dalam [senarai e-Mandate](/ms/e-mandates/). > **Note** > Jika tarikh yang anda nampak berbeza daripada jadual di atas, hubungi team Bayarcash. ## Bayaran berulang di kedai online anda Jika anda menjual langganan atau derma berulang, plugin akan menetapkan Direct Debit untuk pelanggan anda. Lihat [Sambungkan WooCommerce kepada Bayarcash](/ms/woocommerce/) dan [Sambungkan GiveWP kepada Bayarcash](/ms/givewp/). Developer boleh memulakan enrolment melalui API. Lihat [Bina integrasi dengan API Bayarcash](/ms/developers/) dan [API reference](https://api-reference.bayarcash.com). ## Isu biasa ### Pelanggan saya mendaftar hari ini. Kenapa belum ada potongan? Bank perlu meluluskan enrolment itu dahulu. Ini biasanya mengambil masa 3 hingga 5 hari. Potongan pertama berlaku selepas itu, pada tarikh di bawah. ### Satu potongan bulanan gagal. Adakah potongan itu akan dicuba semula? Ya. Jika potongan bulanan pertama gagal, potongan itu dicuba sekali lagi antara 25 hingga 28 haribulan pada bulan yang sama. ### Hari apa potongan mingguan dibuat? Setiap hari Jumaat. Potongan pertama berlaku pada hari Jumaat, dua minggu selepas hari enrolment. --- # Direct Debit何时扣款 > 每周、每月和每年Direct Debit从登记到每次扣款的流程,以及每月扣款失败后何时重试。 > > Source: https://docs.bayarcash.com/zh/direct-debit-deduction-schedule/ Direct Debit按固定周期从顾客的银行账户扣款:每周、每月或每年。Bayarcash不提供每日Direct Debit。在第一次扣款之前,银行必须先批准登记。 ## 每月Direct Debit 以下说明每月付款一次的顾客会经历什么。 1. 你的顾客申请登记每月付款的Direct Debit。 2. 申请等待银行批准,通常需要3到5天。 3. 批准后,登记就会生效。 4. 第一次扣款安排在登记月份的下一个月的3日至5日。 5. 如果第一次扣款失败,会在同一个月的25日至28日之间再试一次。 ## 每周Direct Debit 以下说明每周付款一次的顾客会经历什么。 1. 你的顾客申请登记每周付款的Direct Debit。 2. 申请等待银行批准,通常需要3到5天。 3. 批准后,登记就会生效。 4. 第一次扣款在登记日两周后的星期五。 5. 之后,每个星期五扣款一次。 ## 每年Direct Debit 每年Direct Debit每年扣款一次。和每周、每月一样,银行必须先批准登记。扣款日期按照e-Mandate。 {/* TODO Hanny: yearly deduction day */} ## 跟进每一笔扣款 每笔登记和扣款都会出现在[Direct Debit交易](/zh/direct-debit-transactions/)中。协议本身在[e-Mandate列表](/zh/e-mandates/)中。 > **Note** > 如果你看到的日期和上面的时间表不同,请联系Bayarcash支持团队。 ## 网店的定期付款 如果你销售订阅或定期捐款,插件会为你的顾客设置Direct Debit。请看[把WooCommerce连接到Bayarcash](/zh/woocommerce/)和[把GiveWP连接到Bayarcash](/zh/givewp/)。开发者可以通过API开始登记:请看[Bayarcash API文档和sandbox](/zh/developers/)和[API reference](https://api-reference.bayarcash.com)。 ## 常见问题 ### 我的顾客今天登记了。为什么还没有扣款? 银行必须先批准登记,通常需要3到5天。之后会在下面的日期进行第一次扣款。 ### 一笔每月扣款失败了。会再试一次吗? 会。第一次每月扣款失败后,会在同一个月的25日至28日之间重试一次。 ### 每周扣款在哪一天进行? 每个星期五。第一次扣款在登记日两周后的星期五。 --- # Change or end a Direct Debit > How a customer ends a Direct Debit themselves, from the link in their email or on the Bayarcash mandate page, and what you can do as a merchant. > > Source: https://docs.bayarcash.com/direct-debit-maintenance-termination/ A customer can end their own Direct Debit without contacting you. They choose one of two ways: the link in the e-Mandate email, or the Bayarcash mandate page. Share this page with a customer who asks how to stop. ## End it from the email Use this when the customer still has the e-Mandate email. 1. Open the e-Mandate email. 2. Select the **termination form** link in the email. 3. Select **Proceed With Termination**. ## End it on the Bayarcash mandate page Use this when the customer would rather do it on the website. 1. Go to the Bayarcash mandate page at https://mandate.bayarcash.com/. 2. Enter the details it asks for. You find them in the e-Mandate email. 3. Follow the screen to finish the termination. ## What a change can do A change (maintenance) updates an e-Mandate that is active. The customer approves each change in their online banking. A change can update these details: - The phone number. - The email. - The amount. - The bank account. The customer selects the new account when they sign in to their online banking. A change cannot move the e-Mandate to a different bank. A change and an end always go to the bank of the enrolment. To pay from a different bank, the customer ends the e-Mandate and enrols again. ## What you can do as a merchant Only the payer can terminate a Direct Debit. As a merchant you can: - Check the status in the [e-Mandate list](/e-mandates/). A terminated e-Mandate shows **Terminated**. - Through the API, stop an active e-Mandate from being deducted without terminating it. - Through the API, start a maintenance or termination request. The customer gets a link to confirm it. Developers: see [Developers](/developers/) and the [API reference](https://api-reference.bayarcash.com). For recurring orders in your shop, see [WooCommerce](/woocommerce/) and [GiveWP](/givewp/). ## Common issues ### My customer wants to stop paying. What do they do? They can end it themselves with the termination form link in their e-Mandate email, or on the Bayarcash mandate page. Steps are below. ### Can I terminate a customer's Direct Debit for them? Only the payer can terminate a Direct Debit. Through the API you can start a termination request that the customer confirms. See Developers (/developers/). ### My customer wants to pay from a different bank. Can they change the e-Mandate? No. A change cannot move an e-Mandate to a different bank. The customer ends the e-Mandate, then enrols again with the new bank. ### My customer cannot find the email. Ask them to search their inbox and spam folder for the e-Mandate email. The mandate page needs details from that email. --- # Tukar atau tamatkan Direct Debit > Cara pelanggan menamatkan Direct Debit sendiri, dari link dalam e-mel atau di page mandate Bayarcash, dan apa yang merchant boleh buat. > > Source: https://docs.bayarcash.com/ms/direct-debit-maintenance-termination/ Pelanggan boleh menamatkan Direct Debit mereka sendiri tanpa menghubungi anda. Ada dua cara: link dalam e-mel e-Mandate, atau page mandate Bayarcash. Kongsi page ini dengan pelanggan yang bertanya cara untuk berhenti. ## Tamatkan dari e-mel Guna cara ini apabila pelanggan masih ada e-mel e-Mandate. 1. Buka e-mel e-Mandate. 2. Klik link **termination form** dalam e-mel itu. 3. Klik **Proceed With Termination**. ## Tamatkan di page mandate Bayarcash Guna cara ini apabila pelanggan lebih suka membuatnya di laman web. 1. Pergi ke page mandate Bayarcash di https://mandate.bayarcash.com/. 2. Masukkan butiran yang diminta. Butiran ini ada dalam e-mel e-Mandate. 3. Ikut arahan pada skrin untuk menyelesaikan termination. ## Apa yang boleh ditukar Perubahan (maintenance) mengemas kini e-Mandate yang aktif. Pelanggan meluluskan setiap perubahan dalam online banking mereka. Perubahan boleh mengemas kini butiran ini: - Nombor telefon. - E-mel. - Amaun. - Akaun bank. Pelanggan memilih akaun baru semasa log masuk ke online banking mereka. Perubahan tidak boleh memindahkan e-Mandate ke bank lain. Setiap perubahan dan termination sentiasa dihantar ke bank yang digunakan semasa enrolment. Untuk membayar dari bank lain, pelanggan perlu menamatkan e-Mandate itu dan membuat enrolment semula. ## Apa yang merchant boleh buat Hanya pembayar boleh menamatkan Direct Debit. Sebagai merchant, anda boleh: - Semak status dalam [senarai e-Mandate](/ms/e-mandates/). E-Mandate yang sudah ditamatkan memaparkan **Terminated**. - Melalui API, hentikan potongan pada e-Mandate yang aktif tanpa menamatkannya. - Melalui API, mulakan permintaan maintenance atau termination. Pelanggan akan menerima link untuk mengesahkannya. Untuk developer: lihat [Bina integrasi dengan API Bayarcash](/ms/developers/) dan [API reference](https://api-reference.bayarcash.com). Untuk pesanan berulang di kedai online anda, lihat [Sambungkan WooCommerce kepada Bayarcash](/ms/woocommerce/) dan [Sambungkan GiveWP kepada Bayarcash](/ms/givewp/). ## Isu biasa ### Pelanggan saya mahu berhenti membayar. Apa yang mereka perlu buat? Pelanggan boleh menamatkannya sendiri melalui link termination form dalam e-mel e-Mandate mereka, atau di page mandate Bayarcash. Langkah-langkahnya ada di bawah. ### Boleh saya tamatkan Direct Debit bagi pihak pelanggan? Tidak. Hanya pembayar boleh menamatkan Direct Debit. Melalui API, anda boleh memulakan permintaan termination, dan pelanggan akan mengesahkannya. Lihat Bina integrasi dengan API Bayarcash (/ms/developers/). ### Pelanggan saya mahu membayar dari bank lain. Bolehkah mereka menukar e-Mandate itu? Tidak. Perubahan tidak boleh memindahkan e-Mandate ke bank lain. Pelanggan perlu menamatkan e-Mandate itu, kemudian membuat enrolment semula dengan bank baru. ### Pelanggan saya tidak jumpa e-mel itu. Apa yang mereka perlu buat? Minta mereka mencari e-mel e-Mandate dalam inbox dan folder spam. Page mandate memerlukan butiran daripada e-mel itu. --- # 修改或终止Direct Debit > 顾客如何通过电邮中的链接或Bayarcash mandate页面自行终止Direct Debit,以及商家能做什么。 > > Source: https://docs.bayarcash.com/zh/direct-debit-maintenance-termination/ 顾客可以自行终止Direct Debit,不需要联系你。他们可以选择两种方法之一:e-Mandate电邮中的链接,或Bayarcash mandate页面。如果有顾客问怎样停止,就把这个页面分享给他们。 ## 从电邮终止 顾客还有e-Mandate电邮时,用这个方法。 1. 打开e-Mandate电邮。 2. 点击电邮中的**termination form**链接。 3. 点击**Proceed With Termination**。 ## 在Bayarcash mandate页面终止 顾客想在网站上操作时,用这个方法。 1. 前往Bayarcash mandate页面:https://mandate.bayarcash.com/。 2. 输入页面要求的资料。这些资料在e-Mandate电邮中。 3. 按照屏幕上的指示完成终止。 ## 可以修改哪些资料 修改(maintenance)用来更新有效的e-Mandate。顾客要在网上银行批准每一次修改。修改可以更新这些资料: - 电话号码。 - 电邮。 - 金额。 - 银行账户。顾客登录网上银行时选择新的账户。 修改不能把e-Mandate转到另一家银行。修改和终止都会送到登记时的银行。如果要用另一家银行付款,顾客要先终止e-Mandate,再重新登记。 ## 商家能做什么 只有付款人可以终止Direct Debit。作为商家,你可以: - 在[e-Mandate列表](/zh/e-mandates/)中查看状态。已终止的e-Mandate会显示**Terminated**。 - 通过API,暂停有效e-Mandate的扣款,但不终止它。 - 通过API,发出修改或终止请求。顾客会收到一个链接来确认。 开发者:请看[Bayarcash API文档和sandbox](/zh/developers/)和[API reference](https://api-reference.bayarcash.com)。 关于你网店的定期订单,请看[把WooCommerce连接到Bayarcash](/zh/woocommerce/)和[把GiveWP连接到Bayarcash](/zh/givewp/)。 ## 常见问题 ### 我的顾客想停止付款。他们要怎么做? 他们可以用e-Mandate电邮中的termination form链接,或在Bayarcash mandate页面上自行终止。步骤在下面。 ### 我可以替顾客终止Direct Debit吗? 只有付款人可以终止Direct Debit。你可以通过API发出终止请求,再由顾客确认。请看Bayarcash API文档和sandbox (/zh/developers/)。 ### 我的顾客想用另一家银行付款。他们可以修改e-Mandate吗? 不可以。修改不能把e-Mandate转到另一家银行。顾客要先终止e-Mandate,再用新的银行重新登记。 ### 我的顾客找不到那封电邮。 请他们在收件箱和垃圾邮件文件夹中搜索e-Mandate电邮。mandate页面需要那封电邮中的资料。 --- # Enrol a customer in Direct Debit from the merchant dashboard > Start a Direct Debit e-Mandate for a customer with New Enrollment, without a website or plugin. > > Source: https://docs.bayarcash.com/direct-debit-enrollment/ **New Enrollment** starts a Direct Debit e-Mandate for a customer from the merchant dashboard. Use it when you do not have a website or plugin that does the enrolment for you. ## Enrol a customer You need the Portal Key of a portal that has Direct Debit turned on. 1. Sign in to the [merchant dashboard](/sign-in/). 2. In the top menu, choose **Transactions**, then choose **e-Mandates**. 3. Choose **New Enrollment**. The **Direct Debit Enrollment** form opens. 4. Fill in the fields. The table below gives each field. 5. Choose **Proceed With Enrollment**. *(Screenshot: The Direct Debit Enrollment form with sample values and the Proceed With Enrollment button highlighted)* The form has these fields: | Field | What to type | |---|---| | **Portal Key** | The key of the portal that receives the deductions. See [Find your API keys](/api-keys/) | | **Name** | The name of the customer | | **Payer ID Number** | The type of ID (**New IC Number**, **Old IC Number**, **Passport Number**, **Business Registration** or **Others**) and the number | | **Mobile Number** and **Email** | The contact details of the customer | | **Payment Reference Number** | Your own reference for this e-Mandate | | **Amount** | The amount of each deduction, in MYR | | **Frequency Mode** | **Weekly** (deductions on Friday), **Monthly** or **Yearly**. Do not choose **Daily**: Bayarcash does not offer it | | **Purpose of Payment** | What the customer pays for | | **Return URL** | The page that opens after the enrolment | | **Raw Website Data** | Extra data from your website, if you have it | ## What your customer does at the bank Your customer approves the e-Mandate in their own online banking, through FPX. Tell them about these steps before they start. 1. Your customer chooses their bank. FPX opens the online banking of that bank. 2. They sign in and select the account for the deductions. The account can be a current, savings or credit card account. 3. They confirm with the TAC or OTP from their bank. 4. The bank takes RM1.00 from the account. Bayarcash does not refund it. The bank statement can show it as "e-Mandate Enrolment". 5. Your customer comes back to your page with the result. ## After the enrolment The new e-Mandate shows in the **Direct Debit e-Mandates** list. Its status changes when the bank replies, usually in 3 to 5 days. See [Check your Direct Debit e-Mandates](/e-mandates/). ## Common issues ### Which ID types can the customer use? New IC Number, Old IC Number, Passport Number, Business Registration or Others. ### How often can a deduction run? Choose Weekly, Monthly or Yearly in Frequency Mode. The list also shows Daily, but Bayarcash does not offer daily Direct Debit. ### My customer sees RM1.00 "e-Mandate Enrolment" on their bank statement. What is it? When the customer approves the e-Mandate in their online banking, the bank takes RM1.00 from the account. Bayarcash does not refund it. --- # Daftarkan pelanggan dalam Direct Debit dari merchant dashboard > Mulakan e-Mandate Direct Debit untuk pelanggan dengan New Enrollment, tanpa laman web atau plugin. > > Source: https://docs.bayarcash.com/ms/direct-debit-enrollment/ **New Enrollment** memulakan e-Mandate Direct Debit untuk pelanggan dari merchant dashboard. Guna cara ini apabila anda tidak ada laman web atau plugin yang membuat enrolment untuk anda. ## Daftarkan pelanggan Anda memerlukan Portal Key bagi portal yang Direct Debit-nya sudah di-on-kan. 1. Log masuk ke [merchant dashboard](/ms/sign-in/). 2. Dalam menu atas, klik **Transactions**, kemudian klik **e-Mandates**. 3. Klik **New Enrollment**. Form **Direct Debit Enrollment** dibuka. 4. Isi ruangan dalam form itu. Jadual di bawah menerangkan setiap ruangan. 5. Klik **Proceed With Enrollment**. *(Screenshot: Form Direct Debit Enrollment dengan contoh nilai dan butang Proceed With Enrollment ditanda)* Form ini ada ruangan berikut: | Ruangan | Apa yang perlu diisi | |---|---| | **Portal Key** | Key bagi portal yang menerima potongan. Lihat [Cari API keys anda](/ms/api-keys/) | | **Name** | Nama pelanggan | | **Payer ID Number** | Jenis ID (**New IC Number**, **Old IC Number**, **Passport Number**, **Business Registration** atau **Others**) dan nombornya | | **Mobile Number** dan **Email** | Nombor telefon dan e-mel pelanggan | | **Payment Reference Number** | Rujukan anda sendiri untuk e-Mandate ini | | **Amount** | Jumlah setiap potongan, dalam MYR | | **Frequency Mode** | **Weekly** (potongan pada hari Jumaat), **Monthly** atau **Yearly**. Jangan pilih **Daily**: Bayarcash tidak menawarkannya | | **Purpose of Payment** | Tujuan bayaran pelanggan | | **Return URL** | Page yang dibuka selepas enrolment | | **Raw Website Data** | Data tambahan dari laman web anda, jika ada | ## Apa yang pelanggan anda buat di bank Pelanggan anda meluluskan e-Mandate dalam online banking mereka sendiri, melalui FPX. Terangkan langkah-langkah ini kepada pelanggan sebelum mereka mula. 1. Pelanggan anda memilih bank mereka. FPX membuka online banking bank itu. 2. Pelanggan log masuk dan memilih akaun untuk potongan. Akaun itu boleh jadi akaun semasa, akaun simpanan atau akaun kad kredit. 3. Pelanggan mengesahkan dengan TAC atau OTP daripada bank mereka. 4. Bank memotong RM1.00 dari akaun itu. Bayarcash tidak refund jumlah ini. Penyata bank mungkin memaparkannya sebagai "e-Mandate Enrolment". 5. Pelanggan anda kembali ke page anda dan nampak keputusannya. ## Selepas enrolment E-Mandate baru itu dipaparkan dalam senarai **Direct Debit e-Mandates**. Statusnya bertukar apabila bank memberi jawapan, biasanya dalam masa 3 hingga 5 hari. Lihat [Semak e-Mandate Direct Debit anda](/ms/e-mandates/). ## Isu biasa ### Jenis ID apa yang pelanggan boleh guna? New IC Number, Old IC Number, Passport Number, Business Registration atau Others. ### Berapa kerap potongan boleh dibuat? Pilih Weekly, Monthly atau Yearly dalam Frequency Mode. Senarai itu juga memaparkan Daily, tetapi Bayarcash tidak menawarkan Direct Debit harian. ### Pelanggan saya nampak RM1.00 "e-Mandate Enrolment" dalam penyata bank mereka. Apa itu? Apabila pelanggan meluluskan e-Mandate dalam online banking mereka, bank memotong RM1.00 dari akaun itu. Bayarcash tidak refund jumlah ini. --- # 从商家后台为顾客登记Direct Debit > 用New Enrollment为顾客开始Direct Debit e-Mandate,不需要网站或插件。 > > Source: https://docs.bayarcash.com/zh/direct-debit-enrollment/ **New Enrollment**可以从商家后台(merchant dashboard)为顾客开始Direct Debit e-Mandate。如果你没有能帮你完成登记的网站或插件,就用这个方法。 ## 为顾客登记 你需要一个已开启Direct Debit的portal的Portal Key。 1. 登录[商家后台](/zh/sign-in/)。 2. 在顶部菜单中,选择**Transactions**,然后选择**e-Mandates**。 3. 选择**New Enrollment**。**Direct Debit Enrollment**表单会打开。 4. 填写各个栏位。下表列出每个栏位。 5. 选择**Proceed With Enrollment**。 *(Screenshot: Direct Debit Enrollment表单,填有示例资料,Proceed With Enrollment按钮已标示)* 表单有以下栏位: | 栏位 | 要输入什么 | |---|---| | **Portal Key** | 接收扣款的portal的key。请看[找到你的API key](/zh/api-keys/) | | **Name** | 顾客的名字 | | **Payer ID Number** | 证件类型(**New IC Number**、**Old IC Number**、**Passport Number**、**Business Registration**或**Others**)和号码 | | **Mobile Number**和**Email** | 顾客的联系资料 | | **Payment Reference Number** | 你自己为这个e-Mandate设的参考号码 | | **Amount** | 每次扣款的金额,以MYR计 | | **Frequency Mode** | **Weekly**(星期五扣款)、**Monthly**或**Yearly**。不要选择**Daily**:Bayarcash不提供每日扣款 | | **Purpose of Payment** | 顾客付款的用途 | | **Return URL** | 登记完成后打开的页面 | | **Raw Website Data** | 来自你网站的额外资料(如果有) | ## 顾客在银行要做什么 顾客通过FPX,在自己的网上银行批准e-Mandate。开始之前,请先告诉他们这些步骤。 1. 顾客选择自己的银行。FPX会打开那家银行的网上银行。 2. 他们登录,并选择用来扣款的账户。这个账户可以是往来账户、储蓄账户或信用卡账户。 3. 他们用银行发送的TAC或OTP确认。 4. 银行从账户扣除RM1.00。Bayarcash不会退还这笔钱。银行月结单可能会显示为“e-Mandate Enrolment”。 5. 顾客回到你的页面,看到结果。 ## 登记之后 新的e-Mandate会出现在**Direct Debit e-Mandates**列表中。银行回复后,它的状态会改变,通常需要3至5天。请看[查看你的Direct Debit e-Mandate](/zh/e-mandates/)。 ## 常见问题 ### 顾客可以用哪些证件类型? New IC Number、Old IC Number、Passport Number、Business Registration或Others。 ### 扣款可以多久进行一次? 在Frequency Mode中选择Weekly、Monthly或Yearly。列表中也有Daily,但Bayarcash不提供每日Direct Debit。 ### 顾客的银行月结单上有一笔RM1.00的“e-Mandate Enrolment”。这是什么? 顾客在网上银行批准e-Mandate时,银行会从账户扣除RM1.00。Bayarcash不会退还这笔钱。 --- # Check your Direct Debit billing files > The Collection Billing Files page lists the billing files of your Direct Debit collections, with their billing date, status and amount. > > Source: https://docs.bayarcash.com/collection-billing-files/ The **Collection Billing Files** page lists the billing files of your Direct Debit collections. Each file has a billing date, a batch ID and a total amount. ## Open the billing files To see the list of billing files: 1. Sign in to the [merchant dashboard](/sign-in/). 2. In the top menu, choose **Transactions**, then choose **Billing Files**. 3. To find one file, choose **Advance Filter**. Then set the **Created Date Range**, the **Billing Date** or the **Batch ID**. *(Screenshot: The Collection Billing Files page with Advance Filter open and highlighted)* The list has these columns: | Column | What it shows | |---|---| | **Created** and **Billing Date** | The date of the record, and the billing date of the file | | **Status** and **Frequency** | The status of the file, and its deduction frequency | | **Batch ID**, **File Name** and **Seller Name** | The references of the file | | **Total Items** and **Amount** | The number of items in the file, and their total amount | To keep a copy of the list, choose **Export CSV**. To see each deduction and its result, see [Check your Direct Debit transactions](/direct-debit-transactions/). For the dates of the deductions, see [When Direct Debit deductions happen](/direct-debit-deduction-schedule/). ## Common issues ### Where are the Direct Debit billing files? In the top menu, choose Transactions, then Billing Files. ### Can I download the list? Yes. On the Collection Billing Files page, choose Export CSV. --- # Semak fail billing Direct Debit anda > Page Collection Billing Files menyenaraikan fail billing bagi collection Direct Debit anda, dengan tarikh billing, status dan jumlahnya. > > Source: https://docs.bayarcash.com/ms/collection-billing-files/ Page **Collection Billing Files** menyenaraikan fail billing bagi collection Direct Debit anda. Setiap fail ada tarikh billing, batch ID dan jumlah keseluruhan. ## Buka fail billing Untuk melihat senarai fail billing: 1. Log masuk ke [merchant dashboard](/ms/sign-in/). 2. Dalam menu atas, klik **Transactions**, kemudian klik **Billing Files**. 3. Untuk mencari satu fail, klik **Advance Filter**. Kemudian tetapkan **Created Date Range**, **Billing Date** atau **Batch ID**. *(Screenshot: Page Collection Billing Files dengan Advance Filter dibuka dan ditanda)* Senarai ini ada lajur berikut: | Lajur | Apa yang dipaparkan | |---|---| | **Created** dan **Billing Date** | Tarikh rekod dibuat, dan tarikh billing fail itu | | **Status** dan **Frequency** | Status fail itu, dan kekerapan potongannya | | **Batch ID**, **File Name** dan **Seller Name** | Rujukan fail itu | | **Total Items** dan **Amount** | Bilangan item dalam fail itu, dan jumlah keseluruhannya | Untuk menyimpan salinan senarai ini, klik **Export CSV**. Untuk melihat setiap potongan dan keputusannya, lihat [Semak transaksi Direct Debit anda](/ms/direct-debit-transactions/). Untuk tarikh potongan, lihat [Bila potongan Direct Debit berlaku](/ms/direct-debit-deduction-schedule/). ## Isu biasa ### Di mana fail billing Direct Debit? Dalam menu atas, klik Transactions, kemudian Billing Files. ### Boleh saya muat turun senarai ini? Boleh. Pada page Collection Billing Files, klik Export CSV. --- # 查看你的Direct Debit账单文件 > Collection Billing Files页面列出你Direct Debit收款的账单文件,包括账单日期、状态和金额。 > > Source: https://docs.bayarcash.com/zh/collection-billing-files/ **Collection Billing Files**页面列出你Direct Debit收款的账单文件。每个文件都有账单日期、batch ID和总金额。 ## 打开账单文件 查看账单文件列表: 1. 登录[商家后台(merchant dashboard)](/zh/sign-in/)。 2. 在顶部菜单选择**Transactions**,然后选择**Billing Files**。 3. 如果要找一个文件,选择**Advance Filter**。然后设置**Created Date Range**、**Billing Date**或**Batch ID**。 *(Screenshot: Collection Billing Files页面,Advance Filter已打开并已标示)* 列表有这些列: | 列 | 显示什么 | |---|---| | **Created**和**Billing Date** | 记录的日期,以及文件的账单日期 | | **Status**和**Frequency** | 文件的状态,以及它的扣款频率 | | **Batch ID**、**File Name**和**Seller Name** | 文件的参考资料 | | **Total Items**和**Amount** | 文件里的项目数量,以及它们的总金额 | 如果要保存这个列表,选择**Export CSV**。 如果要查看每笔扣款和它的结果,请看[查看你的Direct Debit交易](/zh/direct-debit-transactions/)。关于扣款的日期,请看[Direct Debit何时扣款](/zh/direct-debit-deduction-schedule/)。 ## 常见问题 ### Direct Debit的账单文件在哪里? 在顶部菜单选择Transactions,然后选择Billing Files。 ### 我可以下载这个列表吗? 可以。在Collection Billing Files页面选择Export CSV。 --- # Connect WooCommerce to Bayarcash > Install the Bayarcash WC plugin, enter your keys for each payment channel you want and take FPX, DuitNow, card, e-wallet and Direct Debit payments. > > Source: https://docs.bayarcash.com/woocommerce/ The **Bayarcash WC** plugin adds Bayarcash to your WooCommerce checkout. Each Bayarcash payment channel is a separate WooCommerce payment method with its own settings page and its own keys, so you set up only the channels you want. The plugin fully supports [WooCommerce Subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/) products. Your customers can pay each renewal by Direct Debit, straight from their bank account. See [Direct Debit for subscriptions](#direct-debit-for-subscriptions). ## What it supports The plugin adds one WooCommerce payment method per channel. This is the name you see in **WooCommerce** → **Settings** → **Payments**, and the title your customers see at checkout until you change it: | Payment method in WooCommerce | Default checkout title | What your customer pays with | |---|---|---| | **Bayarcash FPX** | Online Banking | FPX online banking | | **Bayarcash DuitNow OBW** | Online Banking | DuitNow Online Banking/Wallets | | **Bayarcash FPX Line of Credit** | FPX Line of Credit | A credit card account through FPX | | **Bayarcash Credit & Debit Card** | Credit & Debit Card | Visa or Mastercard | | **Bayarcash DuitNow QR** | DuitNow QR | Any DuitNow QR banking or e-wallet app | | **Bayarcash Shopee Pay** | SPayLater / Shopee Pay | ShopeePay or SPayLater | | **Bayarcash BNPL by Boost** | Boost PayFlex | Boost PayFlex | | **Bayarcash Boost PayFlex** | Boost PayFlex | Boost PayFlex and Boost Wallet | | **Bayarcash Touch 'n Go eWallet** | Touch 'n Go eWallet | Touch 'n Go eWallet | | **Bayarcash GrabPay** | GrabPay | GrabPay | | **Bayarcash Grab PayLater** | Grab PayLater | PayLater by Grab | | **Bayarcash QRIS Online Banking** | Indonesia Online Banking | Indonesian online banking (QRIS) | | **Bayarcash QRIS e-Wallet** | Indonesia e-Wallet | Indonesian e-wallets (QRIS) | | **Bayarcash NETS Singapore** | NETS Singapore | NETS (Singapore) | | **Bayarcash Alipay** | Alipay | Alipay | | **Bayarcash WeChat Pay** | WeChat Pay | WeChat Pay | | **Bayarcash PromptPay Thailand** | PromptPay | PromptPay (Thailand) | | **Bayarcash Direct Debit** | Recurring Direct Debit | Weekly or monthly deductions from a bank account | **Bayarcash Direct Debit** only appears when WooCommerce Subscriptions is active. A channel only works if it is also turned on for your Bayarcash portal. See [Payment channels](/payment-channels/) and [Cross-border payment channels](/cross-border-channels/). ## Before you start You need these before you set up the plugin: - An approved Bayarcash merchant account. - Your **Personal Access Token (PAT)**, **API Secret Key** and **Portal Key**. See [Find your API keys](/api-keys/). - WooCommerce installed and active, with the store currency set to Malaysian ringgit (MYR). - A site that is online and served over HTTPS, so Bayarcash can send payment results back to it. ## Install the plugin The plugin is free on WordPress.org as [Bayarcash WooCommerce](https://wordpress.org/plugins/bayarcash-wc/). To install it: 1. In WordPress, go to **Plugins** → **Add New**. 2. Search for **Bayarcash WC** and click **Install**. 3. Click **Activate**. ## Set up a payment channel Repeat these steps for every channel you want to offer. Each channel's settings page has its own copy of every field below. 1. Go to **WooCommerce** → **Settings** → **Payments** and open the Bayarcash channel you want, for example **Bayarcash FPX**. 2. Tick **Enable/Disable**. 3. Leave **Sandbox Mode** cleared for real payments. See [Test in sandbox](#test-in-sandbox) below. 4. Optional: change **Title** and **Description**, the text your customer sees at checkout. 5. Under **Credentials**, paste your token into **Personal Access Token (PAT)**. The plugin checks it and shows "PAT Token is valid". You can also click **Verify Token**. 6. Choose your portal in **Portal Key**. The list fills in once the token is valid. 7. Paste your key into **API Secret Key**. 8. Click **Save changes**. > **Tip** > Already set up one channel? On the next one, choose that channel in **Copy Credentials** and click **Copy**. It copies the token, secret key, portal key and **Sandbox Mode** setting in one go. ## Optional settings Each channel also has these settings, under **Miscellaneous** and **Additional Charges**: | Setting | What it does | |---|---| | **Country Restrictions** | Shows the channel only to customers from one country. **Off** shows it to everyone. | | **Email Fallback** | The email sent to Bayarcash when your checkout does not ask the customer for one. | | **Debug Mode** | Writes extra detail to the WooCommerce logs (**WooCommerce** → **System Status** → **Logs**) for troubleshooting. | | **Place Order Text** | The checkout button text. `{total}` shows the cart total. | | **Logo Size Unit** and **Logo Size** | The size of the channel logo at checkout. | | **Enable Additional Charges** | Adds a fee to the order when the customer pays with this channel, set with **Fee Name**, **Charge Type** and **Charge Amount**. | To take payments into more than one Bayarcash account, use the **Bayarcash Multi-Merchant** tab in **WooCommerce** → **Settings**. It adds extra FPX and DuitNow payment methods, each with its own keys. ## Test in sandbox Test on the Bayarcash sandbox before you take real payments: 1. Get a token, secret key and portal key from the [sandbox merchant dashboard](https://console.bayarcash-sandbox.com). Live keys do not work in the sandbox. 2. On the channel's settings page, tick **Sandbox Mode**, enter the sandbox keys and click **Save changes**. 3. Place a test order and pay it. 4. When it works, clear **Sandbox Mode**, enter your live keys and save again. Sandbox mode is set per channel, so check each channel you tested. ## How payment results reach your store You do not paste a callback URL into the merchant dashboard. The plugin sends its own return and callback address with each payment, on your site at `/?wc-api=bayarcash_callback`. When the payment ends, Bayarcash sends the result there and the plugin updates the order. It also re-checks unpaid orders on a schedule. If orders stay pending after a successful payment, make sure your site is public, uses HTTPS, and that no firewall, security plugin or maintenance mode blocks `?wc-api=` addresses. See [Callbacks and checksum](/callbacks-and-checksum/). ## Direct Debit for subscriptions Bayarcash Direct Debit works with WooCommerce Subscriptions. The customer signs an e-mandate once, and Bayarcash then deducts each renewal from their bank account. To use it: 1. Install and activate WooCommerce Subscriptions. 2. Set up **Bayarcash Direct Debit** like any other channel. 3. Create subscription products billed every week or every month. Other billing periods are refused at checkout. At checkout the customer fills in **Identification Type** and **Identification Number**, then approves the e-mandate with their bank. Their bank account is charged a small verification amount, and the order note says whether bank verification passed. A cart can hold one subscription and no other items. For when deductions happen and how to follow them, see [Direct Debit deduction schedule](/direct-debit-deduction-schedule/) and [Direct Debit transactions](/direct-debit-transactions/). ## Tips Two habits make a WooCommerce setup smoother: - **Set up only the channels your portal can take.** A channel that is not turned on for your portal shows a warning in its settings and fails at checkout. - **Use a separate portal for each shop.** Reports and payouts are easier to reconcile when each site has its own portal. ## Common issues ### I saved my settings but the payment method is switched off again. Why? The plugin turns a channel off when Personal Access Token (PAT), Portal Key or API Secret Key is empty, and shows "Please enter portal key", "Please enter Personal Access Token (PAT)" or "Please enter API secret key". Each channel keeps its own keys, so fill in all three on that channel's settings page, or use Copy Credentials. ### I get a PAT error: Verify Token says "Invalid PAT Token". What is wrong? The token is wrong, or it comes from the other environment. With Sandbox Mode ticked, use a token from the sandbox merchant dashboard. With it cleared, use a token from the live merchant dashboard. Copy the full token again, with no space before or after it, then click Verify Token. See Find your API keys (/api-keys/). ### A channel shows a warning that it "is not enabled for this portal". What do I do? The portal you picked cannot take that channel yet. Choose a different portal, or ask Bayarcash to turn the channel on for this portal. See Payment channels (/payment-channels/). ### Customers see "This payment method only supports Malaysian Ringgit (MYR) currency." at checkout. Bayarcash takes payments in MYR only. Set your store currency to Malaysian ringgit (MYR) in your WooCommerce general settings. ### I cannot cancel a Direct Debit order. Why? The plugin blocks it and shows "Direct Debit orders cannot be cancelled." To stop future deductions, cancel the subscription instead, or end the e-mandate. See Change or end a Direct Debit mandate (/direct-debit-maintenance-termination/). --- # Sambungkan WooCommerce kepada Bayarcash > Install plugin Bayarcash WC dan masukkan keys bagi setiap saluran untuk terima bayaran FPX, DuitNow, kad, e-wallet dan Direct Debit. > > Source: https://docs.bayarcash.com/ms/woocommerce/ Plugin **Bayarcash WC** menambah Bayarcash pada checkout WooCommerce anda. Setiap saluran bayaran Bayarcash menjadi satu kaedah bayaran WooCommerce yang berasingan, dengan page tetapan dan keys sendiri. Jadi anda hanya perlu sediakan saluran yang anda mahu. Plugin ini menyokong sepenuhnya produk [WooCommerce Subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/). Pelanggan anda boleh membayar setiap pembaharuan langganan melalui Direct Debit, terus dari akaun bank mereka. Lihat [Direct Debit untuk langganan](#direct-debit-untuk-langganan). ## Saluran yang disokong Plugin ini menambah satu kaedah bayaran WooCommerce bagi setiap saluran. Anda nampak nama ini dalam **WooCommerce** → **Settings** → **Payments**. Pelanggan anda nampak tajuk default semasa checkout, sehingga anda menukarnya: | Kaedah bayaran dalam WooCommerce | Tajuk default semasa checkout | Cara pelanggan anda membayar | |---|---|---| | **Bayarcash FPX** | Online Banking | Perbankan online FPX | | **Bayarcash DuitNow OBW** | Online Banking | DuitNow Online Banking/Wallets | | **Bayarcash FPX Line of Credit** | FPX Line of Credit | Akaun kad kredit melalui FPX | | **Bayarcash Credit & Debit Card** | Credit & Debit Card | Visa atau Mastercard | | **Bayarcash DuitNow QR** | DuitNow QR | Mana-mana aplikasi bank atau e-wallet yang menyokong DuitNow QR | | **Bayarcash Shopee Pay** | SPayLater / Shopee Pay | ShopeePay atau SPayLater | | **Bayarcash BNPL by Boost** | Boost PayFlex | Boost PayFlex | | **Bayarcash Boost PayFlex** | Boost PayFlex | Boost PayFlex dan Boost Wallet | | **Bayarcash Touch 'n Go eWallet** | Touch 'n Go eWallet | Touch 'n Go eWallet | | **Bayarcash GrabPay** | GrabPay | GrabPay | | **Bayarcash Grab PayLater** | Grab PayLater | PayLater by Grab | | **Bayarcash QRIS Online Banking** | Indonesia Online Banking | Perbankan online Indonesia (QRIS) | | **Bayarcash QRIS e-Wallet** | Indonesia e-Wallet | E-wallet Indonesia (QRIS) | | **Bayarcash NETS Singapore** | NETS Singapore | NETS (Singapura) | | **Bayarcash Alipay** | Alipay | Alipay | | **Bayarcash WeChat Pay** | WeChat Pay | WeChat Pay | | **Bayarcash PromptPay Thailand** | PromptPay | PromptPay (Thailand) | | **Bayarcash Direct Debit** | Recurring Direct Debit | Potongan mingguan atau bulanan dari akaun bank | **Bayarcash Direct Debit** hanya dipaparkan apabila WooCommerce Subscriptions aktif. Sesuatu saluran hanya berfungsi jika saluran itu juga di-on-kan untuk portal Bayarcash anda. Lihat [Saluran bayaran](/ms/payment-channels/) dan [Saluran bayaran cross-border](/ms/cross-border-channels/). ## Sebelum anda mula Anda memerlukan perkara ini sebelum anda sediakan plugin: - Akaun merchant Bayarcash yang sudah diluluskan. - **Personal Access Token (PAT)**, **API Secret Key** dan **Portal Key** anda. Lihat [Cari API keys anda](/ms/api-keys/). - WooCommerce yang sudah di-install dan aktif. Mata wang kedai mesti ringgit Malaysia (MYR). - Laman web yang online dan menggunakan HTTPS, supaya Bayarcash boleh menghantar keputusan bayaran kembali ke laman web itu. ## Install plugin Plugin ini percuma di WordPress.org dengan nama [Bayarcash WooCommerce](https://wordpress.org/plugins/bayarcash-wc/). Untuk install plugin ini: 1. Dalam WordPress, pergi ke **Plugins** → **Add New**. 2. Cari **Bayarcash WC** dan klik **Install**. 3. Klik **Activate**. ## Sediakan saluran bayaran Ulang langkah ini bagi setiap saluran yang anda mahu tawarkan. Page tetapan setiap saluran ada semua ruangan di bawah ini, dengan nilai sendiri. 1. Pergi ke **WooCommerce** → **Settings** → **Payments** dan buka saluran Bayarcash yang anda mahu, contohnya **Bayarcash FPX**. 2. Tandakan **Enable/Disable**. 3. Untuk bayaran sebenar, jangan tandakan **Sandbox Mode**. Lihat [Uji dalam sandbox](#uji-dalam-sandbox) di bawah. 4. Pilihan: tukar **Title** dan **Description**. Pelanggan anda nampak teks ini semasa checkout. 5. Di bawah **Credentials**, paste token anda ke dalam **Personal Access Token (PAT)**. Plugin menyemak token itu dan memaparkan "PAT Token is valid". Anda juga boleh klik **Verify Token**. 6. Pilih portal anda dalam **Portal Key**. Senarai ini hanya diisi selepas token itu sah. 7. Paste key anda ke dalam **API Secret Key**. 8. Klik **Save changes**. > **Tip** > Sudah sediakan satu saluran? Pada saluran seterusnya, pilih saluran itu dalam **Copy Credentials** dan klik **Copy**. Plugin copy token, secret key, portal key dan tetapan **Sandbox Mode** sekali gus. ## Tetapan pilihan Setiap saluran juga ada tetapan ini, di bawah **Miscellaneous** dan **Additional Charges**: | Tetapan | Fungsi | |---|---| | **Country Restrictions** | Saluran ini hanya dipaparkan kepada pelanggan dari satu negara. **Off** memaparkannya kepada semua pelanggan. | | **Email Fallback** | E-mel yang dihantar kepada Bayarcash apabila checkout anda tidak meminta e-mel pelanggan. | | **Debug Mode** | Menulis butiran tambahan dalam logs WooCommerce (**WooCommerce** → **System Status** → **Logs**) untuk mencari punca masalah. | | **Place Order Text** | Teks pada butang checkout. `{total}` memaparkan jumlah cart. | | **Logo Size Unit** dan **Logo Size** | Saiz logo saluran semasa checkout. | | **Enable Additional Charges** | Menambah caj pada pesanan apabila pelanggan membayar dengan saluran ini. Tetapkan caj itu dengan **Fee Name**, **Charge Type** dan **Charge Amount**. | Untuk menerima bayaran ke dalam lebih daripada satu akaun Bayarcash, guna tab **Bayarcash Multi-Merchant** dalam **WooCommerce** → **Settings**. Tab ini menambah kaedah bayaran FPX dan DuitNow tambahan, dan setiap satu ada keys sendiri. ## Uji dalam sandbox Uji dalam sandbox Bayarcash sebelum anda terima bayaran sebenar: 1. Dapatkan token, secret key dan portal key dari [merchant dashboard sandbox](https://console.bayarcash-sandbox.com). Keys live tidak berfungsi dalam sandbox. 2. Pada page tetapan saluran itu, tandakan **Sandbox Mode**, masukkan keys sandbox dan klik **Save changes**. 3. Buat satu pesanan ujian dan bayar pesanan itu. 4. Apabila semuanya berfungsi, buang tanda **Sandbox Mode**, masukkan keys live anda dan simpan semula. Sandbox mode ditetapkan bagi setiap saluran. Jadi semak setiap saluran yang anda uji. ## Cara keputusan bayaran sampai ke kedai anda Anda tidak perlu paste URL callback ke dalam merchant dashboard. Plugin ini menghantar alamat return dan callback sendiri bersama setiap bayaran, iaitu `/?wc-api=bayarcash_callback` pada laman web anda. Apabila bayaran selesai, Bayarcash menghantar keputusan ke alamat itu dan plugin mengemas kini pesanan. Plugin juga menyemak semula pesanan yang belum dibayar mengikut jadual. Jika pesanan kekal pending selepas bayaran berjaya, pastikan laman web anda terbuka kepada umum dan menggunakan HTTPS. Pastikan juga tiada firewall, plugin keselamatan atau maintenance mode yang menyekat alamat `?wc-api=`. Lihat [Callback dan checksum](/ms/callbacks-and-checksum/). ## Direct Debit untuk langganan Bayarcash Direct Debit berfungsi dengan WooCommerce Subscriptions. Pelanggan menandatangani e-mandate sekali sahaja. Selepas itu, Bayarcash memotong bayaran setiap pembaharuan dari akaun bank pelanggan. Untuk menggunakan Direct Debit: 1. Install dan aktifkan WooCommerce Subscriptions. 2. Sediakan **Bayarcash Direct Debit** sama seperti saluran lain. 3. Cipta produk langganan dengan bil setiap minggu atau setiap bulan. Tempoh bil lain akan ditolak semasa checkout. Semasa checkout, pelanggan mengisi **Identification Type** dan **Identification Number**, kemudian meluluskan e-mandate dengan bank mereka. Bank mengenakan amaun pengesahan yang kecil pada akaun pelanggan. Nota pesanan menunjukkan sama ada pengesahan bank berjaya. Satu cart hanya boleh ada satu langganan dan tiada item lain. Untuk mengetahui bila potongan dibuat dan cara memantaunya, lihat [Jadual potongan Direct Debit](/ms/direct-debit-deduction-schedule/) dan [Transaksi Direct Debit](/ms/direct-debit-transactions/). ## Tips Dua habit ini memudahkan setup WooCommerce anda: - **Sediakan hanya saluran yang portal anda boleh terima.** Saluran yang tidak di-on-kan untuk portal anda memaparkan amaran dalam tetapannya dan gagal semasa checkout. - **Guna portal yang berasingan bagi setiap kedai.** Laporan dan payout lebih mudah di-reconcile apabila setiap laman web ada portal sendiri. ## Isu biasa ### Saya sudah simpan tetapan, tetapi kaedah bayaran itu off semula. Kenapa? Plugin ini off-kan sesuatu saluran apabila Personal Access Token (PAT), Portal Key atau API Secret Key kosong, dan memaparkan "Please enter portal key", "Please enter Personal Access Token (PAT)" atau "Please enter API secret key". Setiap saluran menyimpan keys sendiri. Isi ketiga-tiganya pada page tetapan saluran itu, atau guna Copy Credentials. ### Kenapa saya dapat ralat PAT, iaitu Verify Token memaparkan "Invalid PAT Token"? Token itu salah, atau token itu dari environment yang lain. Jika Sandbox Mode ditandakan, guna token dari merchant dashboard sandbox. Jika tidak ditandakan, guna token dari merchant dashboard live. Copy semula token itu sepenuhnya, tanpa ruang sebelum atau selepasnya, kemudian klik Verify Token. Lihat Cari API keys anda (/ms/api-keys/). ### Sesuatu saluran memaparkan amaran bahawa saluran itu "is not enabled for this portal". Apa yang saya perlu buat? Portal yang anda pilih belum boleh menerima saluran itu. Pilih portal lain, atau minta Bayarcash on-kan saluran itu untuk portal ini. Lihat Saluran bayaran (/ms/payment-channels/). ### Kenapa pelanggan nampak "This payment method only supports Malaysian Ringgit (MYR) currency." semasa checkout? Bayarcash hanya menerima bayaran dalam MYR. Tetapkan mata wang kedai anda kepada ringgit Malaysia (MYR) dalam tetapan umum WooCommerce. ### Kenapa saya tidak dapat batalkan pesanan Direct Debit? Plugin ini menyekat pembatalan itu dan memaparkan "Direct Debit orders cannot be cancelled." Untuk menghentikan potongan seterusnya, batalkan langganan itu, atau tamatkan e-mandate. Lihat Tukar atau tamatkan mandate Direct Debit (/ms/direct-debit-maintenance-termination/). --- # 把WooCommerce连接到Bayarcash > 安装Bayarcash WC插件,为每个付款渠道输入key,接受FPX、DuitNow、卡、电子钱包和Direct Debit付款。 > > Source: https://docs.bayarcash.com/zh/woocommerce/ **Bayarcash WC**插件把Bayarcash加入你的WooCommerce结账页面。每个Bayarcash付款渠道都是一个独立的WooCommerce付款方式,有自己的设置页面和key,所以你只需设置你要的渠道。 这个插件完全支持[WooCommerce Subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/)产品。你的顾客可以用Direct Debit,直接从银行账户支付每一期续费。请看[订阅付款用Direct Debit](#订阅付款用direct-debit)。 ## 支持的付款渠道 插件为每个渠道添加一个WooCommerce付款方式。你会在**WooCommerce** → **Settings** → **Payments**看到以下名称。在你修改之前,顾客在结账页面看到的是默认标题: | WooCommerce中的付款方式 | 默认结账标题 | 顾客用什么付款 | |---|---|---| | **Bayarcash FPX** | Online Banking | FPX网上银行 | | **Bayarcash DuitNow OBW** | Online Banking | DuitNow Online Banking/Wallets | | **Bayarcash FPX Line of Credit** | FPX Line of Credit | 通过FPX使用信用卡账户 | | **Bayarcash Credit & Debit Card** | Credit & Debit Card | Visa或Mastercard | | **Bayarcash DuitNow QR** | DuitNow QR | 任何支持DuitNow QR的银行或电子钱包App | | **Bayarcash Shopee Pay** | SPayLater / Shopee Pay | ShopeePay或SPayLater | | **Bayarcash BNPL by Boost** | Boost PayFlex | Boost PayFlex | | **Bayarcash Boost PayFlex** | Boost PayFlex | Boost PayFlex和Boost Wallet | | **Bayarcash Touch 'n Go eWallet** | Touch 'n Go eWallet | Touch 'n Go eWallet | | **Bayarcash GrabPay** | GrabPay | GrabPay | | **Bayarcash Grab PayLater** | Grab PayLater | PayLater by Grab | | **Bayarcash QRIS Online Banking** | Indonesia Online Banking | 印尼网上银行(QRIS) | | **Bayarcash QRIS e-Wallet** | Indonesia e-Wallet | 印尼电子钱包(QRIS) | | **Bayarcash NETS Singapore** | NETS Singapore | NETS(新加坡) | | **Bayarcash Alipay** | Alipay | Alipay | | **Bayarcash WeChat Pay** | WeChat Pay | WeChat Pay | | **Bayarcash PromptPay Thailand** | PromptPay | PromptPay(泰国) | | **Bayarcash Direct Debit** | Recurring Direct Debit | 每周或每月从银行账户扣款 | **Bayarcash Direct Debit**只在WooCommerce Subscriptions启用时出现。渠道也必须在你的Bayarcash portal开启,才能使用。请看[付款渠道](/zh/payment-channels/)和[跨境付款渠道](/zh/cross-border-channels/)。 ## 开始之前 设置插件之前,你需要准备以下几项: - 已批准的Bayarcash商家账号。 - 你的**Personal Access Token (PAT)**、**API Secret Key**和**Portal Key**。请看[找到你的API key](/zh/api-keys/)。 - 已安装并启用的WooCommerce,商店币种设为马来西亚令吉(MYR)。 - 一个已上线并使用HTTPS的网站,让Bayarcash可以把付款结果发回给它。 ## 安装插件 这个插件在WordPress.org免费提供,名称是[Bayarcash WooCommerce](https://wordpress.org/plugins/bayarcash-wc/)。安装方法: 1. 在WordPress中,前往**Plugins** → **Add New**。 2. 搜索**Bayarcash WC**,然后点击**Install**。 3. 点击**Activate**。 ## 设置付款渠道 为每个你要提供的渠道重复以下步骤。每个渠道的设置页面都有下面所有栏位,各自分开填写。 1. 前往**WooCommerce** → **Settings** → **Payments**,打开你要的Bayarcash渠道,例如**Bayarcash FPX**。 2. 勾选**Enable/Disable**。 3. 收取真实付款时,不要勾选**Sandbox Mode**。请看下面的[在sandbox测试](#在sandbox测试)。 4. 可选:修改**Title**和**Description**,也就是顾客在结账页面看到的文字。 5. 在**Credentials**下,把你的token粘贴到**Personal Access Token (PAT)**。插件会检查它,并显示“PAT Token is valid”。你也可以点击**Verify Token**。 6. 在**Portal Key**选择你的portal。token有效后,列表才会出现选项。 7. 把你的key粘贴到**API Secret Key**。 8. 点击**Save changes**。 > **Tip** > 已经设置好一个渠道?在下一个渠道,于**Copy Credentials**选择那个渠道,然后点击**Copy**。它会一次复制token、secret key、portal key和**Sandbox Mode**设置。 ## 可选设置 每个渠道在**Miscellaneous**和**Additional Charges**下,还有以下设置: | 设置 | 作用 | |---|---| | **Country Restrictions** | 只向来自某一个国家的顾客显示这个渠道。**Off**表示向所有人显示。 | | **Email Fallback** | 当你的结账页面没有要求顾客填写电邮时,发送给Bayarcash的电邮。 | | **Debug Mode** | 把更多细节写入WooCommerce日志(**WooCommerce** → **System Status** → **Logs**),方便排查问题。 | | **Place Order Text** | 结账按钮的文字。`{total}`会显示购物车总额。 | | **Logo Size Unit**和**Logo Size** | 结账页面上渠道logo的大小。 | | **Enable Additional Charges** | 顾客用这个渠道付款时,在订单上加收手续费,用**Fee Name**、**Charge Type**和**Charge Amount**设置。 | 要把款项收进多于一个Bayarcash账号,请使用**WooCommerce** → **Settings**中的**Bayarcash Multi-Merchant**标签页。它会添加额外的FPX和DuitNow付款方式,每个都有自己的key。 ## 在sandbox测试 收取真实付款之前,先在Bayarcash sandbox测试: 1. 从[sandbox商家后台](https://console.bayarcash-sandbox.com)取得token、secret key和portal key。正式环境的key在sandbox不能使用。 2. 在该渠道的设置页面,勾选**Sandbox Mode**,输入sandbox的key,然后点击**Save changes**。 3. 下一张测试订单并付款。 4. 测试成功后,取消勾选**Sandbox Mode**,输入你的正式key,然后再次保存。 Sandbox模式是按渠道设置的,所以请检查每个你测试过的渠道。 ## 付款结果如何回传到你的网店 你不需要把callback URL粘贴到商家后台。插件会在每笔付款中发送自己的return和callback地址,也就是你网站上的`/?wc-api=bayarcash_callback`。付款结束时,Bayarcash会把结果发到这个地址,插件就会更新订单。插件也会定时重新检查未付款的订单。 如果付款成功后订单仍然是pending,请确认你的网站是公开的、使用HTTPS,而且没有防火墙、安全插件或维护模式阻挡`?wc-api=`地址。请看[Callback和checksum](/zh/callbacks-and-checksum/)。 ## 订阅付款用Direct Debit Bayarcash Direct Debit可以与WooCommerce Subscriptions一起使用。顾客只需签署一次e-Mandate,之后Bayarcash会从顾客的银行账户扣取每一期续费。 使用方法: 1. 安装并启用WooCommerce Subscriptions。 2. 像其他渠道一样,设置**Bayarcash Direct Debit**。 3. 创建每周或每月收费的订阅产品。其他收费周期会在结账时被拒绝。 结账时,顾客填写**Identification Type**和**Identification Number**,然后在银行批准e-Mandate。银行会从顾客的账户扣取一笔小额验证金额,订单备注会显示银行验证是否通过。一个购物车只能有一个订阅,不能有其他产品。 要了解什么时候扣款,以及如何跟进,请看[Direct Debit何时扣款](/zh/direct-debit-deduction-schedule/)和[查看你的Direct Debit交易](/zh/direct-debit-transactions/)。 ## 小贴士 两个习惯让WooCommerce设置更顺利: - **只设置你的portal可以接受的渠道**。没有为你的portal开启的渠道,会在设置中显示警告,并在结账时失败。 - **每个网店使用独立的portal**。每个网站有自己的portal,报告和payout(款项转入你的银行账户)对账起来更容易。 ## 常见问题 ### 我已经保存设置,但付款方式又被关闭了。为什么? 当Personal Access Token (PAT)、Portal Key或API Secret Key是空的,插件会关闭该渠道,并显示“Please enter portal key”、“Please enter Personal Access Token (PAT)”或“Please enter API secret key”。每个渠道都有自己的key,所以请在该渠道的设置页面填写全部三项,或使用Copy Credentials。 ### 我遇到PAT错误:Verify Token显示“Invalid PAT Token”。哪里出错了? token不正确,或它来自另一个环境。勾选Sandbox Mode时,请用sandbox商家后台的token。没有勾选时,请用正式商家后台的token。重新复制完整的token,前后不要有空格,然后点击Verify Token。请看找到你的API key (/zh/api-keys/)。 ### 某个渠道显示警告,说它“is not enabled for this portal”。我该怎么做? 你选择的portal还不能接受这个渠道。请选择另一个portal,或请Bayarcash为这个portal开启该渠道。请看付款渠道 (/zh/payment-channels/)。 ### 顾客在结账页面看到“This payment method only supports Malaysian Ringgit (MYR) currency.” Bayarcash只接受MYR付款。请在WooCommerce的一般设置中,把商店币种设为马来西亚令吉(MYR)。 ### 我无法取消Direct Debit订单。为什么? 插件会阻止取消,并显示“Direct Debit orders cannot be cancelled.”要停止之后的扣款,请改为取消订阅,或终止e-Mandate。请看修改或终止Direct Debit e-Mandate (/zh/direct-debit-maintenance-termination/)。 --- # Send BCL payment links from WooCommerce orders > Install BCL Payment Link to make a BCL payment link for an unpaid WooCommerce order, send it to your customer and update the order when they pay. > > Source: https://docs.bayarcash.com/bcl-payment-link/ **BCL Payment Link** adds a **BCL Payment Link** column to your WooCommerce orders list. For an unpaid order, you make a BCL payment link with one click. Then you send it to your customer, for example by WhatsApp or email. When the customer pays, the plugin marks the order as paid. Use it to recover orders that customers did not complete. The plugin uses [BCL](https://bcl.my), which takes the payment through Bayarcash. See [What is Bayarcash](/what-is-bayarcash/). ## What it supports All links from your site use one payment method. You choose it in **Payment Method**: | Option | What your customer pays with | |---|---| | **FPX (Current & Saving Account)** | FPX online banking | | **Line of Credit** | A credit card account through FPX | | **DuitNow OBW** | DuitNow online banking or e-wallet | ## Before you start You need these before you set up the plugin: - WooCommerce installed and active. The plugin needs it. - A BCL account that is connected to Bayarcash. To register, go to [bcl.my/register](https://bcl.my/register). - A BCL API token with **API Read** and **API Write**. See [Create an API token](https://docs.bcl.my/api-tokens/) in the BCL help centre. - Your Bayarcash **Portal Key**. See [Find your API keys](/api-keys/). ## Install the plugin The plugin is free on WordPress.org as [BCL Payment Link](https://wordpress.org/plugins/bcl-payment-link/). To install it: 1. In WordPress, go to **Plugins** → **Add New**. 2. Search for **BCL Payment Link** and click **Install**. 3. Click **Activate**. ## Set up the plugin The settings are on a tab of the WooCommerce settings: 1. Go to **WooCommerce** → **Settings** and open the **BCL Payment Link** tab. The **Settings** link under the plugin on the **Plugins** page opens the same tab. 2. Fill in the fields: | Field | What to enter | |---|---| | **API Token** | Your BCL API token. Required. | | **Portal Key** | Your Bayarcash portal key. Required. | | **Order Prefix** | A short code for this site, for example `SITEA`. Required. BCL gets the order number as prefix, hyphen and order number, for example `SITEA-116`. | | **Payment Method** | The payment method for every link. It is **FPX (Current & Saving Account)** until you change it. | 3. Save the changes. ## Send a payment link Do this for each unpaid order: 1. Go to **WooCommerce** → **Orders**. 2. In the **BCL Payment Link** column of the order, click **Generate Payment Link**. The plugin shows "Payment link generated successfully. Refreshing page..." and loads the page again. 3. Click **Copy Link**. The button shows "Copied!". 4. Send the link to your customer. The plugin also adds a private order note with the link: "BCL payment link generated: ...". The link uses the amount, name, email and phone number of the order. ## How the order is updated The plugin checks the status of each link about once a minute. It checks the 50 newest orders that have a link and the status Pending payment, On hold, Cancelled or Failed. Then it changes the order: | Payment result in BCL | Order status | Order note | |---|---|---| | Paid | Processing | "Payment received via BCL Payment Link" | | Cancelled | Cancelled | "Payment cancelled" | | Failed | Failed | "Payment failed" | While the payment is new or pending, the order stays as it is. ## Tips - **Use a different Order Prefix on each site.** The plugin finds each payment by its order number. Two sites with one prefix can mix their payments. - **Run WP-Cron from the server.** On a quiet site, set up a server cron job for WP-Cron. Paid orders then change status on time. ## Common issues ### Clicking Generate Payment Link shows "Error: Failed to generate payment link". What do I check? Check the API Token and the Portal Key in WooCommerce → Settings → BCL Payment Link. The token must have API Write. The WooCommerce logs, source bcl-payment-link, show the reply from BCL. ### My customer paid, but the order still shows Pending payment. Why? The plugin checks the payment about once a minute with WP-Cron, which runs only when someone opens your site. On a quiet site the check can come late. Also, do not change Order Prefix after you send a link: the check looks for the order number with the current prefix. ### Some orders have no Generate Payment Link button. Why? The plugin shows the button only for unpaid orders. A paid order shows "Order Paid", or "Order Paid via BCL" when it was paid with a BCL payment link. --- # Hantar payment link BCL dari pesanan WooCommerce > Install BCL Payment Link, buat payment link BCL bagi pesanan WooCommerce yang belum dibayar, dan pesanan dikemas kini apabila pelanggan bayar. > > Source: https://docs.bayarcash.com/ms/bcl-payment-link/ **BCL Payment Link** menambah lajur **BCL Payment Link** pada senarai pesanan WooCommerce anda. Untuk pesanan yang belum dibayar, anda boleh buat payment link BCL dengan satu klik. Kemudian, hantar link itu kepada pelanggan anda, contohnya melalui WhatsApp atau e-mel. Apabila pelanggan membayar, plugin ini menandakan pesanan itu sebagai sudah dibayar. Guna plugin ini untuk mendapatkan semula pesanan yang pelanggan tidak selesaikan. Plugin ini menggunakan [BCL](https://bcl.my), yang menerima bayaran melalui Bayarcash. Lihat [Apa itu Bayarcash & apa bezanya dengan BCL?](/ms/what-is-bayarcash/) ## Kaedah bayaran yang disokong Semua link dari laman web anda menggunakan satu kaedah bayaran. Anda pilih kaedah itu dalam **Payment Method**: | Pilihan | Cara pelanggan anda membayar | |---|---| | **FPX (Current & Saving Account)** | Online banking FPX | | **Line of Credit** | Akaun kad kredit melalui FPX | | **DuitNow OBW** | Online banking atau e-wallet DuitNow | ## Sebelum anda mula Sediakan perkara ini sebelum anda menyediakan plugin itu: - WooCommerce yang sudah di-install dan aktif. Plugin ini memerlukannya. - Akaun BCL yang sudah disambungkan kepada Bayarcash. Untuk mendaftar, pergi ke [bcl.my/register](https://bcl.my/register). - API token BCL dengan **API Read** dan **API Write**. Lihat [Cipta API token](https://docs.bcl.my/ms/api-tokens/) dalam Help Centre BCL. - **Portal Key** Bayarcash anda. Lihat [Cari API keys anda](/ms/api-keys/). ## Install plugin Plugin ini percuma di WordPress.org sebagai [BCL Payment Link](https://wordpress.org/plugins/bcl-payment-link/). Untuk install plugin ini: 1. Dalam WordPress, pergi ke **Plugins** → **Add New**. 2. Cari **BCL Payment Link** dan klik **Install**. 3. Klik **Activate**. ## Sediakan plugin Tetapan plugin ini ada pada satu tab dalam tetapan WooCommerce: 1. Pergi ke **WooCommerce** → **Settings** dan buka tab **BCL Payment Link**. Link **Settings** di bawah plugin ini pada page **Plugins** juga membuka tab yang sama. 2. Isi ruangan ini: | Ruangan | Apa yang perlu dimasukkan | |---|---| | **API Token** | API token BCL anda. Wajib. | | **Portal Key** | Portal key Bayarcash anda. Wajib. | | **Order Prefix** | Kod pendek untuk laman web ini, contohnya `SITEA`. Wajib. BCL menerima nombor pesanan sebagai prefix, tanda sempang dan nombor pesanan, contohnya `SITEA-116`. | | **Payment Method** | Kaedah bayaran untuk semua link. Nilainya **FPX (Current & Saving Account)** sehingga anda menukarnya. | 3. Simpan perubahan. ## Hantar payment link Buat langkah ini untuk setiap pesanan yang belum dibayar: 1. Pergi ke **WooCommerce** → **Orders**. 2. Dalam lajur **BCL Payment Link** bagi pesanan itu, klik **Generate Payment Link**. Plugin ini memaparkan "Payment link generated successfully. Refreshing page..." dan memuatkan semula page itu. 3. Klik **Copy Link**. Butang itu memaparkan "Copied!". 4. Hantar link itu kepada pelanggan anda. Plugin ini juga menambah nota pesanan peribadi dengan link itu: "BCL payment link generated: ...". Link itu menggunakan amaun, nama, e-mel dan nombor telefon pada pesanan itu. ## Cara pesanan dikemas kini Plugin ini menyemak status setiap link lebih kurang sekali seminit. Plugin ini menyemak 50 pesanan terbaru yang ada link dan berstatus Pending payment, On hold, Cancelled atau Failed. Kemudian, plugin ini menukar pesanan itu: | Keputusan bayaran dalam BCL | Status pesanan | Nota pesanan | |---|---|---| | Paid | Processing | "Payment received via BCL Payment Link" | | Cancelled | Cancelled | "Payment cancelled" | | Failed | Failed | "Payment failed" | Selagi bayaran itu baru atau pending, pesanan itu kekal seperti biasa. ## Tips - **Guna Order Prefix yang berbeza pada setiap laman web.** Plugin ini mencari setiap bayaran mengikut nombor pesanannya. Jika dua laman web menggunakan prefix yang sama, bayaran kedua-duanya boleh bercampur. - **Jalankan WP-Cron dari server.** Jika laman web anda kurang trafik, sediakan cron job pada server untuk WP-Cron. Dengan cara ini, status pesanan yang sudah dibayar bertukar tepat pada masanya. ## Isu biasa ### Kenapa Generate Payment Link memaparkan "Error: Failed to generate payment link"? Semak API Token dan Portal Key dalam WooCommerce → Settings → BCL Payment Link. Token itu mesti ada API Write. Log WooCommerce, dengan sumber bcl-payment-link, menunjukkan jawapan daripada BCL. ### Kenapa pesanan masih Pending payment walaupun pelanggan saya sudah bayar? Plugin ini menyemak bayaran lebih kurang sekali seminit melalui WP-Cron, dan WP-Cron hanya berjalan apabila seseorang membuka laman web anda. Jika laman web anda kurang trafik, semakan itu boleh lambat. Jangan tukar Order Prefix selepas anda menghantar link: semakan itu mencari nombor pesanan dengan prefix yang sedang digunakan. ### Kenapa sesetengah pesanan tiada butang Generate Payment Link? Plugin ini memaparkan butang itu untuk pesanan yang belum dibayar sahaja. Pesanan yang sudah dibayar memaparkan "Order Paid", atau "Order Paid via BCL" jika pesanan itu dibayar melalui payment link BCL. --- # 从WooCommerce订单发送BCL付款链接 > 安装BCL Payment Link,为未付款的WooCommerce订单生成BCL付款链接发给顾客,顾客付款后订单自动更新。 > > Source: https://docs.bayarcash.com/zh/bcl-payment-link/ **BCL Payment Link**会在你的WooCommerce订单列表中添加一个**BCL Payment Link**列。对于未付款的订单,你点击一下就能生成BCL付款链接。然后把链接发给顾客,例如通过WhatsApp或电邮。顾客付款后,插件会把订单标为已付。你可以用它挽回顾客没有完成的订单。 这个插件使用[BCL](https://bcl.my),BCL通过Bayarcash收款。请参阅[什么是Bayarcash](/zh/what-is-bayarcash/)。 ## 支持的付款方式 你网站的所有链接都使用同一种付款方式。你在**Payment Method**中选择: | 选项 | 顾客用什么付款 | |---|---| | **FPX (Current & Saving Account)** | FPX网上银行 | | **Line of Credit** | 通过FPX使用信用卡账户 | | **DuitNow OBW** | DuitNow网上银行或电子钱包 | ## 开始之前 设置插件之前,你需要准备: - 已安装并启用的WooCommerce。这个插件需要它。 - 一个已连接到Bayarcash的BCL账号。如需注册,请前往[bcl.my/register](https://bcl.my/register)。 - 一个有**API Read**和**API Write**的BCL API token。请参阅BCL帮助中心的[创建API token](https://docs.bcl.my/zh/api-tokens/)。 - 你的Bayarcash **Portal Key**。请参阅[找到你的API key](/zh/api-keys/)。 ## 安装插件 这个插件在WordPress.org上免费提供,名为[BCL Payment Link](https://wordpress.org/plugins/bcl-payment-link/)。安装步骤如下: 1. 在WordPress中,前往**Plugins** → **Add New**。 2. 搜索**BCL Payment Link**,然后点击**Install**。 3. 点击**Activate**。 ## 设置插件 设置位于WooCommerce设置中的一个标签页: 1. 前往**WooCommerce** → **Settings**,然后打开**BCL Payment Link**标签页。**Plugins**页面中插件下方的**Settings**链接也会打开同一个标签页。 2. 填写以下栏位: | 栏位 | 要填写什么 | |---|---| | **API Token** | 你的BCL API token。必填。 | | **Portal Key** | 你的Bayarcash portal key。必填。 | | **Order Prefix** | 这个网站的简短代码,例如`SITEA`。必填。BCL收到的订单号码是前缀、连字符加订单号码,例如`SITEA-116`。 | | **Payment Method** | 所有链接使用的付款方式。在你更改之前,它默认是**FPX (Current & Saving Account)**。 | 3. 保存更改。 ## 发送付款链接 为每个未付款的订单执行以下步骤: 1. 前往**WooCommerce** → **Orders**。 2. 在订单的**BCL Payment Link**列中,点击**Generate Payment Link**。插件会显示“Payment link generated successfully. Refreshing page...”,然后重新载入页面。 3. 点击**Copy Link**。按钮会显示“Copied!”。 4. 把链接发给顾客。 插件也会添加一条附有链接的私人订单备注:“BCL payment link generated: ...”。链接使用订单的金额、姓名、电邮和电话号码。 ## 订单如何更新 插件大约每分钟检查一次每个链接的状态。它检查最新的50个有链接、并且状态为Pending payment、On hold、Cancelled或Failed的订单。然后它会更改订单: | BCL中的付款结果 | 订单状态 | 订单备注 | |---|---|---| | Paid | Processing | “Payment received via BCL Payment Link” | | Cancelled | Cancelled | “Payment cancelled” | | Failed | Failed | “Payment failed” | 付款仍是新建或待处理状态时,订单保持不变。 ## 小贴士 - **每个网站使用不同的Order Prefix。** 插件按订单号码查找每笔付款。两个网站使用同一个前缀,付款可能会混在一起。 - **从服务器运行WP-Cron。** 如果网站访客很少,请在服务器上为WP-Cron设置cron job。这样,已付款订单的状态就会准时更新。 ## 常见问题 ### 点击Generate Payment Link后显示“Error: Failed to generate payment link”。我应该检查什么? 检查WooCommerce → Settings → BCL Payment Link中的API Token和Portal Key。token必须有API Write。WooCommerce日志(来源bcl-payment-link)会显示BCL的回复。 ### 顾客已经付款,但订单仍显示Pending payment。为什么? 插件通过WP-Cron大约每分钟检查一次付款,而WP-Cron只在有人打开你的网站时才运行。如果网站访客很少,检查可能会延迟。另外,发送链接后不要更改Order Prefix:检查时是用当前的前缀查找订单号码。 ### 为什么有些订单没有Generate Payment Link按钮? 插件只为未付款的订单显示这个按钮。已付款的订单会显示“Order Paid”;如果是通过BCL付款链接付款,则显示“Order Paid via BCL”。 --- # Connect GiveWP to Bayarcash > Install the Bayarcash GiveWP plugin to collect one-off donations by FPX, DuitNow and more, and recurring donations by Direct Debit. > > Source: https://docs.bayarcash.com/givewp/ The **Bayarcash GiveWP** plugin adds Bayarcash to your GiveWP donation forms. Donors can give once by FPX, DuitNow and other channels, or give every week or month by Direct Debit. Recurring donations need the [Recurring Donations for GiveWP](https://givewp.com/addons/recurring-donations/) add-on. Bayarcash then deducts each donation from the donor's bank account by itself, at a flat-rate fee. See [Recurring donations by Direct Debit](#recurring-donations-by-direct-debit). To see the plugin at work before you install it, try the [live demo](https://givewp.bayarcash-demo.com/). ## What it supports Each Bayarcash channel is a separate GiveWP payment gateway. You can turn on as many as you like: | Gateway in GiveWP | What the donor pays with | |---|---| | **Online Banking** | FPX online banking. Also runs recurring donations by Direct Debit. | | **Online Banking (DuitNow)** | DuitNow Online Banking/Wallets | | **Credit Card** | FPX Line of Credit: a credit card account through FPX, not a card payment. See [FPX Line of Credit](/fpx-line-of-credit/) | | **DuitNow QR** | Any DuitNow QR banking or e-wallet app | | **Boost PayFlex** | Boost PayFlex | | **Indonesia Online Banking** | Indonesian online banking (QRIS) | | **Indonesia e-Wallet** | Indonesian e-wallets (QRIS) | | **NETS** | NETS (Singapore) | | **Alipay** | Alipay | | **WeChat Pay** | WeChat Pay | | **PromptPay** | PromptPay (Thailand) | A channel only works if it is also turned on for your Bayarcash portal. See [Payment channels](/payment-channels/). ## Before you start You need these before you set up the plugin: - An approved Bayarcash merchant account. - Your **Personal Access Token (PAT)**, **API Secret Key** and **Portal Key**. See [Find your API keys](/api-keys/). - GiveWP installed and active, with the currency set to Malaysian ringgit (MYR). - For recurring donations, the GiveWP Recurring Donations add-on. ## Install the plugin The plugin is free on WordPress.org as [Bayarcash GiveWP](https://wordpress.org/plugins/bayarcash-givewp/). To install it: 1. In WordPress, go to **Plugins** → **Add New**. 2. Search for **Bayarcash GiveWP** and click **Install**. 3. Click **Activate**. ## Enter your keys The Bayarcash settings page has one tab per channel, and each tab keeps its own keys. Fill in the tab of every channel you want to use: 1. Go to **Donations** → **Settings** → **Payment Gateways**, then open the **Bayarcash** section. 2. Click the channel's tab, for example **Online Banking**. 3. Paste your token into **Personal Access Token (PAT)** and click **Verify Token**. It shows "PAT Token is valid" when the token works. 4. Choose your portal in **Portal Key**. The list fills in once the token is valid. 5. Paste your key into **API Secret Key**. 6. Optional: set **Billing Fields** to **Enabled** to ask donors for their billing details, and **Enable Phone field** to **Enabled** to ask for a phone number on one-off donations. 7. Click **Save changes**. ## Turn on the gateways The keys alone do not show Bayarcash on your forms. Turn on each gateway in GiveWP too: 1. In **Donations** → **Settings** → **Payment Gateways**, open GiveWP's list of gateways. 2. Tick each Bayarcash gateway you set up, for example **Online Banking** and **DuitNow QR**. 3. Optional: rename the label donors see, for example to "Online Banking (FPX)". 4. Save. ## Use different keys on one form Each donation form can use its own Bayarcash account or portal, which helps when you want each campaign's money reported separately. In the form editor, open the Bayarcash channel's tab and choose an option: | Option | When to use it | |---|---| | **Global Option** | Use the keys from the Bayarcash settings page. | | **Customize** | Enter a different **Personal Access Token (PAT)**, **Portal Key** and **API Secret Key** for this form only. | | **Disable** | Hide this channel on this form. | ## Test in sandbox The plugin follows GiveWP's test mode. When test mode is on, every Bayarcash payment goes to the Bayarcash sandbox, using the keys you entered: 1. Get a token, secret key and portal key from the [sandbox merchant dashboard](https://console.bayarcash-sandbox.com). Live keys do not work in the sandbox. 2. Turn on GiveWP's test mode. 3. Enter the sandbox keys on the Bayarcash settings page and save. 4. Make a test donation. 5. When it works, turn off test mode, enter your live keys and save again. ## How payment results reach your site You do not paste a callback URL into the merchant dashboard. The plugin sends its own address with each donation, on your site at `/give-api/bayarcash_gateway/`, and Bayarcash sends the result there. The plugin also re-checks pending donations every 5 minutes. If donations stay pending after a successful payment, make sure your site is public, uses HTTPS, and that no firewall or security plugin blocks that address. See [Callbacks and checksum](/callbacks-and-checksum/). ## Recurring donations by Direct Debit With the GiveWP Recurring Donations add-on, donors can give every week or every month by Direct Debit. The donor signs an e-mandate once, and Bayarcash deducts each donation from their bank account. To take recurring donations: 1. Install and activate GiveWP Recurring Donations. 2. Set up the **Online Banking** gateway as above. 3. Make the form recurring, with a weekly or monthly period. On a recurring form the donor fills in **Phone Number**, **Identification Type** and **Identification Number**, then approves the e-mandate with their bank. Their bank account is charged a small, non-refundable verification amount, and the receipt says so. See [Direct Debit deduction schedule](/direct-debit-deduction-schedule/) and [e-Mandates](/e-mandates/). ## Tips Two habits help with donations: - **Use a separate portal for each campaign.** A per-form portal keeps each campaign's donations apart in your Bayarcash reports. - **Keep donor emails short on recurring forms.** Direct Debit takes emails of up to 27 characters, so a long address blocks the donation. ## Common issues ### Verify Token says "Invalid PAT Token". What is wrong? The token is wrong, or it comes from the other environment. With GiveWP test mode on, use a token from the sandbox merchant dashboard. With it off, use a token from the live merchant dashboard. See Find your API keys (/api-keys/). ### Donors see "Email length reaches a limit of 27 characters." What does it mean? For recurring donations by Direct Debit, the donor's email can be at most 27 characters. For one-off donations the limit is 50. Ask the donor to use a shorter email address. ### Donors see "Please tick the create account button if you want to create a subscription donation". A recurring donation needs a donor account. The donor should tick the option to create an account on the donation form, then try again. ### I only see the Online Banking option on my recurring form. Where are the other channels? Recurring donations are collected by Direct Debit, which runs through the Online Banking gateway. The other Bayarcash channels are hidden on recurring forms and only take one-off donations. --- # Sambungkan GiveWP kepada Bayarcash > Install plugin Bayarcash GiveWP untuk terima derma sekali sahaja melalui FPX, DuitNow dan lain-lain, serta derma berulang melalui Direct Debit. > > Source: https://docs.bayarcash.com/ms/givewp/ Plugin **Bayarcash GiveWP** menambah Bayarcash pada form derma GiveWP anda. Penderma boleh menderma sekali melalui FPX, DuitNow dan saluran lain. Penderma juga boleh menderma setiap minggu atau setiap bulan melalui Direct Debit. Derma berulang memerlukan add-on [Recurring Donations for GiveWP](https://givewp.com/addons/recurring-donations/). Selepas itu, Bayarcash memotong setiap derma dari akaun bank penderma secara automatik, dengan caj tetap. Lihat [Derma berulang melalui Direct Debit](#derma-berulang-melalui-direct-debit). Untuk melihat plugin ini berfungsi sebelum anda install, cuba [demo langsung](https://givewp.bayarcash-demo.com/). ## Saluran yang disokong Setiap saluran Bayarcash menjadi satu payment gateway GiveWP yang berasingan. Anda boleh on-kan seberapa banyak yang anda mahu: | Gateway dalam GiveWP | Cara penderma membayar | |---|---| | **Online Banking** | Perbankan online FPX. Gateway ini juga menjalankan derma berulang melalui Direct Debit. | | **Online Banking (DuitNow)** | DuitNow Online Banking/Wallets | | **Credit Card** | FPX Line of Credit: akaun kad kredit melalui FPX, bukan bayaran kad. Lihat [FPX Line of Credit](/ms/fpx-line-of-credit/) | | **DuitNow QR** | Mana-mana aplikasi bank atau e-wallet yang menyokong DuitNow QR | | **Boost PayFlex** | Boost PayFlex | | **Indonesia Online Banking** | Perbankan online Indonesia (QRIS) | | **Indonesia e-Wallet** | E-wallet Indonesia (QRIS) | | **NETS** | NETS (Singapura) | | **Alipay** | Alipay | | **WeChat Pay** | WeChat Pay | | **PromptPay** | PromptPay (Thailand) | Sesuatu saluran hanya berfungsi jika saluran itu juga di-on-kan untuk portal Bayarcash anda. Lihat [Saluran bayaran](/ms/payment-channels/). ## Sebelum anda mula Anda memerlukan perkara ini sebelum anda sediakan plugin: - Akaun merchant Bayarcash yang sudah diluluskan. - **Personal Access Token (PAT)**, **API Secret Key** dan **Portal Key** anda. Lihat [Cari API keys anda](/ms/api-keys/). - GiveWP yang sudah di-install dan aktif. Mata wang mesti ringgit Malaysia (MYR). - Untuk derma berulang, add-on GiveWP Recurring Donations. ## Install plugin Plugin ini percuma di WordPress.org dengan nama [Bayarcash GiveWP](https://wordpress.org/plugins/bayarcash-givewp/). Untuk install plugin ini: 1. Dalam WordPress, pergi ke **Plugins** → **Add New**. 2. Cari **Bayarcash GiveWP** dan klik **Install**. 3. Klik **Activate**. ## Masukkan keys anda Page tetapan Bayarcash ada satu tab bagi setiap saluran, dan setiap tab menyimpan keys sendiri. Isi tab bagi setiap saluran yang anda mahu guna: 1. Pergi ke **Donations** → **Settings** → **Payment Gateways**, kemudian buka bahagian **Bayarcash**. 2. Klik tab saluran itu, contohnya **Online Banking**. 3. Paste token anda ke dalam **Personal Access Token (PAT)** dan klik **Verify Token**. Plugin memaparkan "PAT Token is valid" apabila token itu berfungsi. 4. Pilih portal anda dalam **Portal Key**. Senarai ini hanya diisi selepas token itu sah. 5. Paste key anda ke dalam **API Secret Key**. 6. Pilihan: tetapkan **Billing Fields** kepada **Enabled** untuk meminta butiran bil penderma. Tetapkan **Enable Phone field** kepada **Enabled** untuk meminta nombor telefon bagi derma sekali sahaja. 7. Klik **Save changes**. ## On-kan gateway Keys sahaja tidak memaparkan Bayarcash pada form anda. Anda juga perlu on-kan setiap gateway dalam GiveWP: 1. Dalam **Donations** → **Settings** → **Payment Gateways**, buka senarai gateway GiveWP. 2. Tandakan setiap gateway Bayarcash yang anda sediakan, contohnya **Online Banking** dan **DuitNow QR**. 3. Pilihan: tukar label yang penderma nampak, contohnya kepada "Online Banking (FPX)". 4. Simpan. ## Guna keys lain pada satu form Setiap form derma boleh menggunakan akaun atau portal Bayarcash sendiri. Ini berguna jika anda mahu melihat kutipan setiap kempen secara berasingan dalam laporan. Dalam editor form, buka tab saluran Bayarcash dan pilih satu pilihan: | Pilihan | Bila perlu guna | |---|---| | **Global Option** | Guna keys dari page tetapan Bayarcash. | | **Customize** | Masukkan **Personal Access Token (PAT)**, **Portal Key** dan **API Secret Key** yang lain untuk form ini sahaja. | | **Disable** | Sembunyikan saluran ini pada form ini. | ## Uji dalam sandbox Plugin ini mengikut test mode GiveWP. Apabila test mode di-on-kan, setiap bayaran Bayarcash pergi ke sandbox Bayarcash, dengan keys yang anda masukkan: 1. Dapatkan token, secret key dan portal key dari [merchant dashboard sandbox](https://console.bayarcash-sandbox.com). Keys live tidak berfungsi dalam sandbox. 2. On-kan test mode GiveWP. 3. Masukkan keys sandbox pada page tetapan Bayarcash dan simpan. 4. Buat satu derma ujian. 5. Apabila semuanya berfungsi, off-kan test mode, masukkan keys live anda dan simpan semula. ## Cara keputusan bayaran sampai ke laman web anda Anda tidak perlu paste URL callback ke dalam merchant dashboard. Plugin ini menghantar alamat sendiri bersama setiap derma, iaitu `/give-api/bayarcash_gateway/` pada laman web anda, dan Bayarcash menghantar keputusan ke alamat itu. Plugin juga menyemak semula derma yang pending setiap 5 minit. Jika derma kekal pending selepas bayaran berjaya, pastikan laman web anda terbuka kepada umum dan menggunakan HTTPS. Pastikan juga tiada firewall atau plugin keselamatan yang menyekat alamat itu. Lihat [Callback dan checksum](/ms/callbacks-and-checksum/). ## Derma berulang melalui Direct Debit Dengan add-on GiveWP Recurring Donations, penderma boleh menderma setiap minggu atau setiap bulan melalui Direct Debit. Penderma menandatangani e-mandate sekali sahaja, dan Bayarcash memotong setiap derma dari akaun bank penderma. Untuk menerima derma berulang: 1. Install dan aktifkan GiveWP Recurring Donations. 2. Sediakan gateway **Online Banking** seperti di atas. 3. Jadikan form itu form derma berulang, dengan tempoh mingguan atau bulanan. Pada form derma berulang, penderma mengisi **Phone Number**, **Identification Type** dan **Identification Number**, kemudian meluluskan e-mandate dengan bank mereka. Bank mengenakan amaun pengesahan yang kecil pada akaun penderma, dan amaun ini tidak dipulangkan. Resit derma menyatakan perkara ini. Lihat [Jadual potongan Direct Debit](/ms/direct-debit-deduction-schedule/) dan [e-Mandate](/ms/e-mandates/). ## Tips Dua habit ini membantu anda mengurus derma: - **Guna portal yang berasingan bagi setiap kempen.** Portal bagi setiap form memisahkan derma setiap kempen dalam laporan Bayarcash anda. - **Pastikan e-mel penderma pendek pada form derma berulang.** Direct Debit hanya menerima e-mel sehingga 27 aksara, jadi alamat yang panjang akan menyekat derma itu. ## Isu biasa ### Kenapa Verify Token memaparkan "Invalid PAT Token"? Token itu salah, atau token itu dari environment yang lain. Jika test mode GiveWP di-on-kan, guna token dari merchant dashboard sandbox. Jika test mode di-off-kan, guna token dari merchant dashboard live. Lihat Cari API keys anda (/ms/api-keys/). ### Penderma nampak "Email length reaches a limit of 27 characters." Apa maksudnya? Untuk derma berulang melalui Direct Debit, e-mel penderma boleh ada maksimum 27 aksara. Untuk derma sekali sahaja, hadnya 50 aksara. Minta penderma guna alamat e-mel yang lebih pendek. ### Kenapa penderma nampak "Please tick the create account button if you want to create a subscription donation"? Derma berulang memerlukan akaun penderma. Penderma perlu tandakan pilihan untuk membuat akaun pada form derma, kemudian cuba semula. ### Kenapa saya hanya nampak pilihan Online Banking pada form derma berulang saya? Derma berulang dikutip melalui Direct Debit, dan Direct Debit berjalan melalui gateway Online Banking. Saluran Bayarcash yang lain tidak dipaparkan pada form derma berulang. Saluran itu hanya menerima derma sekali sahaja. --- # 把GiveWP连接到Bayarcash > 安装Bayarcash GiveWP插件,用FPX、DuitNow等渠道收取一次性捐款,并用Direct Debit收取定期捐款。 > > Source: https://docs.bayarcash.com/zh/givewp/ **Bayarcash GiveWP**插件把Bayarcash加入你的GiveWP捐款表单。捐款人可以通过FPX、DuitNow和其他渠道捐一次,也可以通过Direct Debit每周或每月捐款。 定期捐款需要[Recurring Donations for GiveWP](https://givewp.com/addons/recurring-donations/)附加服务(add-on)。之后,Bayarcash会自动从捐款人的银行账户扣除每一笔捐款,并收取固定手续费。请参阅[用Direct Debit定期捐款](#用direct-debit定期捐款)。 安装之前想先看看插件怎样运作,可以试试[在线演示](https://givewp.bayarcash-demo.com/)。 ## 支持的渠道 每个Bayarcash渠道都是一个独立的GiveWP支付网关。你想开启多少个都可以: | GiveWP里的支付网关 | 捐款人用什么付款 | |---|---| | **Online Banking** | FPX网上银行。也用来运行Direct Debit定期捐款。 | | **Online Banking (DuitNow)** | DuitNow Online Banking/Wallets | | **Credit Card** | FPX Line of Credit:通过FPX使用信用卡账户,不是刷卡付款。请参阅[FPX Line of Credit](/zh/fpx-line-of-credit/) | | **DuitNow QR** | 任何支持DuitNow QR的银行或电子钱包App | | **Boost PayFlex** | Boost PayFlex | | **Indonesia Online Banking** | 印尼网上银行(QRIS) | | **Indonesia e-Wallet** | 印尼电子钱包(QRIS) | | **NETS** | NETS(新加坡) | | **Alipay** | Alipay | | **WeChat Pay** | WeChat Pay | | **PromptPay** | PromptPay(泰国) | 一个渠道必须同时在你的Bayarcash portal开启,才能使用。请参阅[付款渠道](/zh/payment-channels/)。 ## 开始之前 设置插件之前,你需要准备好这些: - 一个已获批准的Bayarcash商家账号。 - 你的**Personal Access Token (PAT)**、**API Secret Key**和**Portal Key**。请参阅[找到你的API key](/zh/api-keys/)。 - 已安装并启用的GiveWP,货币设为马来西亚令吉(MYR)。 - 如果要收定期捐款,需要GiveWP Recurring Donations附加服务。 ## 安装插件 这个插件在WordPress.org免费提供,名称是[Bayarcash GiveWP](https://wordpress.org/plugins/bayarcash-givewp/)。安装步骤: 1. 在WordPress里,前往**Plugins** → **Add New**。 2. 搜索**Bayarcash GiveWP**,然后点击**Install**。 3. 点击**Activate**。 ## 输入你的key Bayarcash设置页面为每个渠道提供一个标签页,每个标签页保存自己的key。为每个你想使用的渠道填写它的标签页: 1. 前往**Donations** → **Settings** → **Payment Gateways**,然后打开**Bayarcash**部分。 2. 点击渠道的标签页,例如**Online Banking**。 3. 把你的token粘贴到**Personal Access Token (PAT)**,然后点击**Verify Token**。token有效时,会显示“PAT Token is valid”。 4. 在**Portal Key**选择你的portal。token验证有效后,列表才会出现选项。 5. 把你的key粘贴到**API Secret Key**。 6. 可选:把**Billing Fields**设为**Enabled**,让捐款人填写账单资料;把**Enable Phone field**设为**Enabled**,在一次性捐款时要求填写电话号码。 7. 点击**Save changes**。 ## 开启支付网关 只输入key,Bayarcash还不会出现在你的表单上。你也需要在GiveWP开启每个支付网关: 1. 在**Donations** → **Settings** → **Payment Gateways**,打开GiveWP的支付网关列表。 2. 勾选每个你设置好的Bayarcash支付网关,例如**Online Banking**和**DuitNow QR**。 3. 可选:更改捐款人看到的名称,例如改成“Online Banking (FPX)”。 4. 保存。 ## 在一个表单使用不同的key 每个捐款表单都可以使用自己的Bayarcash账号或portal。如果你想分开查看每个筹款活动的款项报告,这会很有用。在表单编辑器里,打开Bayarcash渠道的标签页,然后选择一个选项: | 选项 | 什么时候使用 | |---|---| | **Global Option** | 使用Bayarcash设置页面里的key。 | | **Customize** | 为这个表单另外输入**Personal Access Token (PAT)**、**Portal Key**和**API Secret Key**。 | | **Disable** | 在这个表单上隐藏这个渠道。 | ## 在sandbox测试 插件跟随GiveWP的测试模式。测试模式开启时,每一笔Bayarcash付款都会进入Bayarcash sandbox,并使用你输入的key: 1. 从[sandbox商家后台(merchant dashboard)](https://console.bayarcash-sandbox.com)获取token、secret key和portal key。正式key不能在sandbox使用。 2. 开启GiveWP的测试模式。 3. 在Bayarcash设置页面输入sandbox key,然后保存。 4. 进行一笔测试捐款。 5. 测试成功后,关闭测试模式,输入你的正式key,然后再保存一次。 ## 付款结果怎样传到你的网站 你不需要把callback URL粘贴到商家后台。插件会在每笔捐款中附上它自己的地址,也就是你网站上的`/give-api/bayarcash_gateway/`,Bayarcash会把结果发送到那里。插件也会每5分钟重新检查一次待处理的捐款。 如果付款成功后捐款仍然是pending,请确认你的网站是公开的、使用HTTPS,而且没有防火墙或安全插件拦截那个地址。请参阅[Callback和checksum](/zh/callbacks-and-checksum/)。 ## 用Direct Debit定期捐款 有了GiveWP Recurring Donations附加服务,捐款人可以通过Direct Debit每周或每月捐款。捐款人只需签一次e-Mandate,Bayarcash就会从他们的银行账户扣除每一笔捐款。 要收取定期捐款: 1. 安装并启用GiveWP Recurring Donations。 2. 按照上面的步骤设置**Online Banking**支付网关。 3. 把表单设为定期捐款,周期选每周或每月。 在定期捐款表单上,捐款人填写**Phone Number**、**Identification Type**和**Identification Number**,然后在银行批准e-Mandate。他们的银行账户会被扣除一笔小额、不可退还的验证金额,收据上也会注明。请参阅[Direct Debit何时扣款](/zh/direct-debit-deduction-schedule/)和[e-Mandate](/zh/e-mandates/)。 ## 小贴士 两个好习惯,让捐款更顺利: - **每个筹款活动使用不同的portal**。每个表单使用自己的portal,可以在Bayarcash报告里把每个筹款活动的捐款分开。 - **定期捐款表单上的捐款人电邮要短**。Direct Debit只接受最多27个字符的电邮,太长的地址会让捐款无法完成。 ## 常见问题 ### Verify Token显示“Invalid PAT Token”,是什么问题? token不正确,或者它来自另一个环境。GiveWP的测试模式开启时,请用sandbox商家后台的token。测试模式关闭时,请用正式环境商家后台的token。请参阅找到你的API key (/zh/api-keys/)。 ### 捐款人看到“Email length reaches a limit of 27 characters.”,这是什么意思? 用Direct Debit定期捐款时,捐款人的电邮最多只能有27个字符。一次性捐款的上限是50个字符。请捐款人使用较短的电邮地址。 ### 捐款人看到“Please tick the create account button if you want to create a subscription donation”。 定期捐款需要捐款人账号。捐款人应在捐款表单上勾选创建账号的选项,然后再试一次。 ### 我的定期捐款表单上只有Online Banking选项,其他渠道去哪里了? 定期捐款通过Direct Debit收取,而Direct Debit是通过Online Banking支付网关运行的。其他Bayarcash渠道在定期捐款表单上会被隐藏,只用于一次性捐款。 --- # Connect Fluent Forms to Bayarcash > Install Bayarcash for Fluent Forms to take FPX, DuitNow, card and cross-border payments on your Fluent Forms Pro payment forms. > > Source: https://docs.bayarcash.com/fluent-forms/ **Bayarcash for Fluent Forms** adds Bayarcash as a payment method on your Fluent Forms Pro payment forms. Your customer fills in the form, pays on the Bayarcash page and comes back to your site. To see the plugin at work before you install it, try the [live demo](https://form.bayarcash-demo.com/fluentform/). ## What it supports The plugin adds one payment method per channel. You pick the ones you want on each form: | Payment method | What your customer pays with | |---|---| | FPX Online Banking | FPX online banking | | Credit Card | A credit card account through FPX | | DuitNow Online Banking | DuitNow Online Banking/Wallets | | DuitNow QR | Any DuitNow QR banking or e-wallet app | | SPayLater | SPayLater by Shopee | | Boost PayFlex | Boost PayFlex | | Indonesia Online Banking | Indonesian online banking (QRIS) | | Indonesia e-Wallet | Indonesian e-wallets (QRIS) | | NETS Singapore | NETS (Singapore) | Payments are one-off and in MYR only. Subscriptions and Direct Debit are not supported. A channel only works if it is also turned on for your Bayarcash portal. See [Payment channels](/payment-channels/). ## Before you start You need these before you set up the plugin: - An approved Bayarcash merchant account. - Your **Personal Access Token (PAT)**, **API Secret Key** and **Portal Key**. See [Find your API keys](/api-keys/). - Fluent Forms Pro installed and active, with the payment currency set to Malaysian ringgit (MYR). ## Install the plugin The plugin is free on WordPress.org as [Bayarcash for Fluent Forms](https://wordpress.org/plugins/bayarcash-for-fluent-forms/). To install it: 1. In WordPress, go to **Plugins** → **Add New**. 2. Search for **Bayarcash for Fluent Forms** and click **Install**. 3. Click **Activate**. ## Enter your keys Enter your keys once for all your forms: 1. Go to **Fluent Forms** → **Bayarcash Settings**. The **Global Configuration** tab opens. 2. Leave **Enable Sandbox Mode** off for real payments. 3. Paste your token into **Personal Access Token** and click **Verify Token**. It shows "Token verified successfully" when the token works. 4. Choose your portal in **Portal Key**. 5. Paste your key into **API Secret Key**. 6. Optional: under **Miscellaneous**, change **Payment Title**. It is **Bayarcash** by default. 7. Save your settings. ## Add Bayarcash to a form Once your keys are saved, turn on the payment methods on each form: 1. Open the form in Fluent Forms and go to its payment settings. 2. Turn on the Bayarcash payment methods you want, for example **FPX Online Banking** and **DuitNow QR**. 3. Optional: change each method's **Method Label**. It is "Pay with" and the method name by default. 4. Save the form. ## Use different keys on one form A form can use its own Bayarcash account or portal instead of the global one: 1. In **Fluent Forms** → **Bayarcash Settings**, open **Form Configuration** and pick the form. 2. Turn on **Customization**. 3. Enter the **Personal Access Token**, **Portal Key** and **API Secret Key** for this form. Here **Portal Key** is a text box, so paste the key from the merchant dashboard. 4. Save your settings. ## Add a processing fee The **Bayarcash Gateway Fee** tab lets you add a fee to the amount your customer pays. You can set it for **FPX Online Banking**, **Credit Card**, **DuitNow Online Banking** and **DuitNow QR**, as a flat amount, a percentage or both, with a description your customer sees. Other channels use the **DuitNow QR** fee. Fees apply to every form. ## Test in sandbox Test on the Bayarcash sandbox before you take real payments: 1. Get a token, secret key and portal key from the [sandbox merchant dashboard](https://console.bayarcash-sandbox.com). Live keys do not work in the sandbox. 2. Turn on **Enable Sandbox Mode**. The page shows "Sandbox mode is enabled. Make sure to use sandbox credentials for testing." 3. Enter the sandbox keys, verify the token and save. 4. Submit a test payment on your form. 5. When it works, turn off **Enable Sandbox Mode**, enter your live keys and save again. A form with **Customization** on has its own **Enable Sandbox Mode** switch. Check it too. ## How payment results reach your site You do not paste a callback URL into the merchant dashboard. The plugin sends its own address with each payment, on your site at `/index.php?fluentform_payment_api_notify=1`, and Bayarcash sends the result there. The plugin then marks the submission paid or failed. If submissions stay pending after a successful payment, make sure your site is public, uses HTTPS, and that no firewall or security plugin blocks that address. See [Callbacks and checksum](/callbacks-and-checksum/). ## Tips Two habits help with Fluent Forms: - **Put a name and email field on every payment form.** Bayarcash needs your customer's name and email to create the payment. - **Use Backup and Restore before big changes.** The **Backup and Restore** tab exports your Bayarcash settings so you can put them back later. ## Common issues ### My form shows "Error! Currency not supported. The only supported currency is MYR". How do I fix it? Bayarcash takes payments in MYR only. Set the currency to Malaysian ringgit in Fluent Forms' payment settings. Until you do, the Bayarcash settings page shows a red notice about non compatible currencies. ### My form shows "Error: Bayarcash does not support subscriptions right now." Bayarcash for Fluent Forms takes one-off payments only. Remove the subscription item from the form, or use a different payment method for it. ### The Portal Key list is empty or says "Please verify Personal Access Token first". The list only fills in after the token is verified. Paste your token into Personal Access Token and click Verify Token. If it says "Verification failed", check that the token matches Enable Sandbox Mode: sandbox tokens for sandbox, live tokens for live. ### I see "Bayarcash for Fluent Forms requires Fluent Forms Pro to be installed and activated." The plugin needs Fluent Forms Pro, not only the free Fluent Forms. Install and activate Fluent Forms Pro, then reload the page. --- # Sambungkan Fluent Forms kepada Bayarcash > Install Bayarcash for Fluent Forms untuk terima bayaran FPX, DuitNow, kad dan saluran cross-border pada payment form Fluent Forms Pro anda. > > Source: https://docs.bayarcash.com/ms/fluent-forms/ **Bayarcash for Fluent Forms** menambah Bayarcash sebagai kaedah bayaran pada payment form Fluent Forms Pro anda. Pelanggan anda mengisi form, membayar di page Bayarcash, kemudian kembali ke laman web anda. Untuk melihat plugin ini berfungsi sebelum anda install, cuba [demo langsung](https://form.bayarcash-demo.com/fluentform/). ## Saluran yang disokong Plugin ini menambah satu kaedah bayaran bagi setiap saluran. Anda pilih kaedah yang anda mahu pada setiap form: | Kaedah bayaran | Cara pelanggan anda membayar | |---|---| | FPX Online Banking | Perbankan online FPX | | Credit Card | Akaun kad kredit melalui FPX | | DuitNow Online Banking | DuitNow Online Banking/Wallets | | DuitNow QR | Mana-mana aplikasi bank atau e-wallet yang menyokong DuitNow QR | | SPayLater | SPayLater by Shopee | | Boost PayFlex | Boost PayFlex | | Indonesia Online Banking | Perbankan online Indonesia (QRIS) | | Indonesia e-Wallet | E-wallet Indonesia (QRIS) | | NETS Singapore | NETS (Singapura) | Plugin ini hanya menerima bayaran sekali sahaja, dalam MYR. Plugin ini tidak menyokong langganan dan Direct Debit. Sesuatu saluran hanya berfungsi jika saluran itu juga di-on-kan untuk portal Bayarcash anda. Lihat [Saluran bayaran](/ms/payment-channels/). ## Sebelum anda mula Anda memerlukan perkara ini sebelum anda sediakan plugin: - Akaun merchant Bayarcash yang sudah diluluskan. - **Personal Access Token (PAT)**, **API Secret Key** dan **Portal Key** anda. Lihat [Cari API keys anda](/ms/api-keys/). - Fluent Forms Pro yang sudah di-install dan aktif. Mata wang bayaran mesti ringgit Malaysia (MYR). ## Install plugin Plugin ini percuma di WordPress.org dengan nama [Bayarcash for Fluent Forms](https://wordpress.org/plugins/bayarcash-for-fluent-forms/). Untuk install plugin ini: 1. Dalam WordPress, pergi ke **Plugins** → **Add New**. 2. Cari **Bayarcash for Fluent Forms** dan klik **Install**. 3. Klik **Activate**. ## Masukkan keys anda Anda hanya perlu masukkan keys sekali untuk semua form anda: 1. Pergi ke **Fluent Forms** → **Bayarcash Settings**. Tab **Global Configuration** dibuka. 2. Untuk bayaran sebenar, biarkan **Enable Sandbox Mode** off. 3. Paste token anda ke dalam **Personal Access Token** dan klik **Verify Token**. Plugin memaparkan "Token verified successfully" apabila token itu berfungsi. 4. Pilih portal anda dalam **Portal Key**. 5. Paste key anda ke dalam **API Secret Key**. 6. Pilihan: di bawah **Miscellaneous**, tukar **Payment Title**. Tajuk default ialah **Bayarcash**. 7. Simpan tetapan anda. ## Tambah Bayarcash pada form Selepas keys anda disimpan, on-kan kaedah bayaran pada setiap form: 1. Buka form itu dalam Fluent Forms dan pergi ke tetapan bayarannya. 2. On-kan kaedah bayaran Bayarcash yang anda mahu, contohnya **FPX Online Banking** dan **DuitNow QR**. 3. Pilihan: tukar **Method Label** bagi setiap kaedah. Label default ialah "Pay with" diikuti nama kaedah itu. 4. Simpan form itu. ## Guna keys lain pada satu form Sesuatu form boleh menggunakan akaun atau portal Bayarcash sendiri, dan bukan tetapan global: 1. Dalam **Fluent Forms** → **Bayarcash Settings**, buka **Form Configuration** dan pilih form itu. 2. On-kan **Customization**. 3. Masukkan **Personal Access Token**, **Portal Key** dan **API Secret Key** untuk form ini. Di sini **Portal Key** ialah kotak teks, jadi paste key itu dari merchant dashboard. 4. Simpan tetapan anda. ## Tambah caj pemprosesan Tab **Bayarcash Gateway Fee** membolehkan anda menambah caj pada amaun yang pelanggan bayar. Anda boleh tetapkan caj untuk **FPX Online Banking**, **Credit Card**, **DuitNow Online Banking** dan **DuitNow QR**. Caj itu boleh jadi amaun tetap, peratusan atau kedua-duanya, dengan keterangan yang pelanggan nampak. Saluran lain menggunakan caj **DuitNow QR**. Caj ini digunakan untuk semua form. ## Uji dalam sandbox Uji dalam sandbox Bayarcash sebelum anda terima bayaran sebenar: 1. Dapatkan token, secret key dan portal key dari [merchant dashboard sandbox](https://console.bayarcash-sandbox.com). Keys live tidak berfungsi dalam sandbox. 2. On-kan **Enable Sandbox Mode**. Page itu memaparkan "Sandbox mode is enabled. Make sure to use sandbox credentials for testing." 3. Masukkan keys sandbox, sahkan token itu dan simpan. 4. Hantar satu test payment pada form anda. 5. Apabila semuanya berfungsi, off-kan **Enable Sandbox Mode**, masukkan keys live anda dan simpan semula. Jika **Customization** di-on-kan pada sesuatu form, form itu ada suis **Enable Sandbox Mode** sendiri. Semak suis itu juga. ## Cara keputusan bayaran sampai ke laman web anda Anda tidak perlu paste URL callback ke dalam merchant dashboard. Plugin ini menghantar alamat sendiri bersama setiap bayaran, iaitu `/index.php?fluentform_payment_api_notify=1` pada laman web anda, dan Bayarcash menghantar keputusan ke alamat itu. Kemudian plugin menandakan submission itu sebagai paid atau failed. Jika submission kekal pending selepas bayaran berjaya, pastikan laman web anda terbuka kepada umum dan menggunakan HTTPS. Pastikan juga tiada firewall atau plugin keselamatan yang menyekat alamat itu. Lihat [Callback dan checksum](/ms/callbacks-and-checksum/). ## Tips Dua habit ini membantu anda dengan Fluent Forms: - **Letak ruangan nama dan e-mel pada setiap payment form.** Bayarcash memerlukan nama dan e-mel pelanggan anda untuk membuat bayaran itu. - **Guna Backup and Restore sebelum perubahan besar.** Tab **Backup and Restore** export tetapan Bayarcash anda, supaya anda boleh pulihkan tetapan itu kemudian. ## Isu biasa ### Form saya memaparkan "Error! Currency not supported. The only supported currency is MYR". Bagaimana saya boleh betulkan? Bayarcash hanya menerima bayaran dalam MYR. Tetapkan mata wang kepada ringgit Malaysia dalam tetapan bayaran Fluent Forms. Selagi anda belum menukarnya, page tetapan Bayarcash memaparkan notis merah tentang mata wang yang tidak serasi. ### Kenapa form saya memaparkan "Error: Bayarcash does not support subscriptions right now."? Bayarcash for Fluent Forms hanya menerima bayaran sekali sahaja. Buang item langganan dari form itu, atau guna kaedah bayaran lain untuk item itu. ### Kenapa senarai Portal Key kosong atau memaparkan "Please verify Personal Access Token first"? Senarai ini hanya diisi selepas token disahkan. Paste token anda ke dalam Personal Access Token dan klik Verify Token. Jika plugin memaparkan "Verification failed", pastikan token itu sepadan dengan tetapan Enable Sandbox Mode. Guna token sandbox untuk sandbox, dan token live untuk live. ### Kenapa saya nampak "Bayarcash for Fluent Forms requires Fluent Forms Pro to be installed and activated."? Plugin ini memerlukan Fluent Forms Pro. Fluent Forms versi percuma sahaja tidak cukup. Install dan aktifkan Fluent Forms Pro, kemudian muat semula page itu. --- # 把Fluent Forms连接到Bayarcash > 安装Bayarcash for Fluent Forms,在Fluent Forms Pro付款表单上收取FPX、DuitNow、卡和跨境付款。 > > Source: https://docs.bayarcash.com/zh/fluent-forms/ **Bayarcash for Fluent Forms**把Bayarcash加入你的Fluent Forms Pro付款表单,成为一种付款方式。你的顾客填写表单,在Bayarcash页面付款,然后回到你的网站。 安装之前想先看看插件怎样运作,可以试试[在线演示](https://form.bayarcash-demo.com/fluentform/)。 ## 支持的渠道 插件为每个渠道添加一种付款方式。你可以为每个表单选择想要的付款方式: | 付款方式 | 你的顾客用什么付款 | |---|---| | FPX Online Banking | FPX网上银行 | | Credit Card | 通过FPX使用信用卡账户 | | DuitNow Online Banking | DuitNow Online Banking/Wallets | | DuitNow QR | 任何支持DuitNow QR的银行或电子钱包App | | SPayLater | Shopee的SPayLater | | Boost PayFlex | Boost PayFlex | | Indonesia Online Banking | 印尼网上银行(QRIS) | | Indonesia e-Wallet | 印尼电子钱包(QRIS) | | NETS Singapore | NETS(新加坡) | 付款只限一次性付款,而且只接受MYR。不支持订阅和Direct Debit。一个渠道必须同时在你的Bayarcash portal开启,才能使用。请参阅[付款渠道](/zh/payment-channels/)。 ## 开始之前 设置插件之前,你需要准备好这些: - 一个已获批准的Bayarcash商家账号。 - 你的**Personal Access Token (PAT)**、**API Secret Key**和**Portal Key**。请参阅[找到你的API key](/zh/api-keys/)。 - 已安装并启用的Fluent Forms Pro,付款货币设为马来西亚令吉(MYR)。 ## 安装插件 这个插件在WordPress.org免费提供,名称是[Bayarcash for Fluent Forms](https://wordpress.org/plugins/bayarcash-for-fluent-forms/)。安装步骤: 1. 在WordPress里,前往**Plugins** → **Add New**。 2. 搜索**Bayarcash for Fluent Forms**,然后点击**Install**。 3. 点击**Activate**。 ## 输入你的key 为所有表单输入一次key就可以: 1. 前往**Fluent Forms** → **Bayarcash Settings**。页面会打开**Global Configuration**标签页。 2. 要收取真实付款,请让**Enable Sandbox Mode**保持关闭。 3. 把你的token粘贴到**Personal Access Token**,然后点击**Verify Token**。token有效时,会显示“Token verified successfully”。 4. 在**Portal Key**选择你的portal。 5. 把你的key粘贴到**API Secret Key**。 6. 可选:在**Miscellaneous**下,更改**Payment Title**。默认是**Bayarcash**。 7. 保存你的设置。 ## 把Bayarcash加入表单 保存key之后,在每个表单开启付款方式: 1. 在Fluent Forms打开表单,前往它的付款设置。 2. 开启你想要的Bayarcash付款方式,例如**FPX Online Banking**和**DuitNow QR**。 3. 可选:更改每种付款方式的**Method Label**。默认是“Pay with”加上付款方式名称。 4. 保存表单。 ## 在一个表单使用不同的key 一个表单可以使用自己的Bayarcash账号或portal,而不是全局设置: 1. 在**Fluent Forms** → **Bayarcash Settings**,打开**Form Configuration**,然后选择表单。 2. 开启**Customization**。 3. 为这个表单输入**Personal Access Token**、**Portal Key**和**API Secret Key**。这里的**Portal Key**是一个文字框,所以请从商家后台(merchant dashboard)复制key并粘贴进去。 4. 保存你的设置。 ## 添加手续费 在**Bayarcash Gateway Fee**标签页,你可以在顾客支付的金额上加一笔手续费。你可以为**FPX Online Banking**、**Credit Card**、**DuitNow Online Banking**和**DuitNow QR**设置手续费,方式可以是固定金额、百分比或两者都用,并加上一段顾客会看到的说明。其他渠道使用**DuitNow QR**的手续费。手续费适用于所有表单。 ## 在sandbox测试 收取真实付款之前,先在Bayarcash sandbox测试: 1. 从[sandbox商家后台](https://console.bayarcash-sandbox.com)获取token、secret key和portal key。正式key不能在sandbox使用。 2. 开启**Enable Sandbox Mode**。页面会显示“Sandbox mode is enabled. Make sure to use sandbox credentials for testing.” 3. 输入sandbox key,验证token,然后保存。 4. 在你的表单提交一笔测试付款。 5. 测试成功后,关闭**Enable Sandbox Mode**,输入你的正式key,然后再保存一次。 开启了**Customization**的表单有自己的**Enable Sandbox Mode**开关,也请检查它。 ## 付款结果怎样传到你的网站 你不需要把callback URL粘贴到商家后台。插件会在每笔付款中附上它自己的地址,也就是你网站上的`/index.php?fluentform_payment_api_notify=1`,Bayarcash会把结果发送到那里。然后插件会把提交记录标为已付款或失败。 如果付款成功后提交记录仍然是pending,请确认你的网站是公开的、使用HTTPS,而且没有防火墙或安全插件拦截那个地址。请参阅[Callback和checksum](/zh/callbacks-and-checksum/)。 ## 小贴士 两个好习惯,让你更顺利使用Fluent Forms: - **每个付款表单都要有姓名和电邮栏位**。Bayarcash需要顾客的姓名和电邮才能创建付款。 - **做大改动之前,先用Backup and Restore**。你可以在**Backup and Restore**标签页导出你的Bayarcash设置,方便之后恢复。 ## 常见问题 ### 我的表单显示“Error! Currency not supported. The only supported currency is MYR”,怎样解决? Bayarcash只接受MYR付款。在Fluent Forms的付款设置里,把货币设为马来西亚令吉。改好之前,Bayarcash设置页面会显示一则红色通知,说明货币不兼容。 ### 我的表单显示“Error: Bayarcash does not support subscriptions right now.” Bayarcash for Fluent Forms只接受一次性付款。请从表单移除订阅项目,或为它使用另一种付款方式。 ### Portal Key列表是空的,或显示“Please verify Personal Access Token first”。 token验证之后,列表才会出现选项。把你的token粘贴到Personal Access Token,然后点击Verify Token。如果显示“Verification failed”,请检查token是否和Enable Sandbox Mode一致:sandbox用sandbox的token,正式环境用正式环境的token。 ### 我看到“Bayarcash for Fluent Forms requires Fluent Forms Pro to be installed and activated.” 这个插件需要Fluent Forms Pro,只有免费版Fluent Forms是不够的。请安装并启用Fluent Forms Pro,然后重新加载页面。 --- # Connect FluentCart to Bayarcash > Install Bayarcash for FluentCart, enter your keys and choose which Bayarcash payment channels your customers can pick at checkout. > > Source: https://docs.bayarcash.com/fluentcart/ **Bayarcash for FluentCart** adds Bayarcash to your FluentCart checkout. Your customer picks a payment channel, pays on the Bayarcash page and comes back to your receipt page. To see the plugin at work before you install it, try the [live demo](https://fluentcart.bayarcash-demo.com/). ## What it supports You choose which channels your customers see at checkout. The options in **Payment Channels** are: | Channel | What your customer pays with | |---|---| | **FPX (Online Banking)** | FPX online banking | | **FPX Line of Credit** | A credit card account through FPX | | **DuitNow Online Banking/Wallets** | DuitNow online banking or e-wallet | | **DuitNow QR** | Any DuitNow QR banking or e-wallet app | | **Credit Card** | Visa or Mastercard | | **Boost PayFlex** | Boost PayFlex | | **QRIS (Online Banking)** | Indonesian online banking | | **QRIS (E-Wallet)** | Indonesian e-wallets | | **NETS** | NETS (Singapore) | | **Alipay** | Alipay | | **WeChat Pay** | WeChat Pay | | **PromptPay** | PromptPay (Thailand) | The list also shows **FPX Direct Debit**. This is the plugin's name for Direct Debit: the customer uses FPX only to approve, change or end the e-Mandate. A channel only works if it is also turned on for your Bayarcash portal. See [Payment channels](/payment-channels/). ## Before you start You need these before you set up the plugin: - An approved Bayarcash merchant account. - Your **Personal Access Token (PAT)**, **API Secret Key** and **Portal Key**. See [Find your API keys](/api-keys/). - FluentCart installed and active, with the store currency set to Malaysian ringgit (MYR). ## Install the plugin The plugin is free on WordPress.org as [Bayarcash for FluentCart](https://wordpress.org/plugins/bayarcash-for-fluentcart/). To install it: 1. In WordPress, go to **Plugins** → **Add New**. 2. Search for **Bayarcash for FluentCart** and click **Install**. 3. Click **Activate**. ## Set up Bayarcash All the settings are on one page: 1. Go to **FluentCart** → **Settings** → **Payments** and open **Bayarcash**. 2. Paste your token into **Personal Access Token (PAT)**. 3. Paste your key into **API Secret Key**. 4. Paste your portal key into **Portal Key**. 5. In **Payment Channels**, tick the channels your customers can choose. **FPX (Online Banking)** and **DuitNow QR** are ticked to start with. 6. Turn Bayarcash on and save. When your store is live, saving shows "Bayarcash gateway credentials verified successfully!". This only confirms the fields are filled in, so make a small test payment to be sure the keys work. ## Change the checkout look The same page sets how the Bayarcash button looks at checkout: | Setting | What it changes | |---|---| | **Bayarcash Checkout Theme** | **Light** or **Dark** | | **Bayarcash Checkout Button Text** | The button text. It is "Pay with Bayarcash" by default. | | **Bayarcash Checkout Button Color** and **Bayarcash Checkout Button Hover Color** | The button colours | | **Bayarcash Checkout Button Text Color** | The colour of the button text | | **Bayarcash Checkout Button Font Size** | The text size, for example `16px` | ## Test in sandbox The plugin has no sandbox switch of its own. It follows your FluentCart store mode: - **Test mode:** payments go to the Bayarcash sandbox, using test keys built into the plugin. The keys you entered are not used, and saving shows "Bayarcash test mode is enabled with your credentials." - **Live mode:** payments go to Bayarcash using the keys you entered. Put your store in test mode, place an order and pay it on the sandbox page. When it works, put your store back in live mode and make one small real payment to check your own keys. ## How payment results reach your store You do not paste a callback URL into the merchant dashboard. The plugin sends its own addresses with each payment: Bayarcash reports the result to your site at `/?fluent-cart=fct_payment_listener_ipn&method=bayarcash`, and your customer returns to your FluentCart receipt page. The plugin then marks the order paid or failed. It never changes an order that is already paid or refunded. If orders stay pending after a successful payment, make sure your site is public, uses HTTPS, and that no firewall or security plugin blocks that address. See [Callbacks and checksum](/callbacks-and-checksum/). ## Tips Two habits help with FluentCart: - **Tick only the channels your portal can take.** Customers who pick a channel that is off for your portal cannot pay. - **Always test once with your live keys.** Test mode uses the plugin's own keys, so it does not prove your keys are right. ## Common issues ### Saving shows "Portal Key is required to activate the gateway." FluentCart needs all three keys before it turns Bayarcash on: Personal Access Token (PAT), API Secret Key and Portal Key. The messages for the other two say the same. See Find your API keys (/api-keys/). ### Checkout shows "Bayarcash payment gateway is not properly configured". Your store is in live mode but one of the three keys is missing. Open FluentCart → Settings → Payments, open Bayarcash, fill in every key and save. ### Saving said "Bayarcash gateway credentials verified successfully!" but payments still fail. Why? That message only means the three fields are filled in. It does not check the keys with Bayarcash. Copy each key again from the merchant dashboard, and make sure the portal can take the channels you ticked. See Why a payment failed (/payment-failed/). ### Checkout shows "Failed to create payment intent". Bayarcash refused the payment request, usually because of a wrong key or a channel that is not turned on for your portal. Check your keys and your ticked Payment Channels. --- # Sambungkan FluentCart kepada Bayarcash > Install Bayarcash for FluentCart, masukkan keys anda dan pilih saluran bayaran Bayarcash yang pelanggan nampak semasa checkout. > > Source: https://docs.bayarcash.com/ms/fluentcart/ **Bayarcash for FluentCart** menambah Bayarcash pada checkout FluentCart anda. Pelanggan anda memilih saluran bayaran, membuat bayaran di page Bayarcash, dan kemudian kembali ke page resit anda. Untuk melihat plugin ini berfungsi sebelum anda install, cuba [demo langsung](https://fluentcart.bayarcash-demo.com/). ## Saluran yang disokong Anda pilih saluran yang pelanggan nampak semasa checkout. Pilihan dalam **Payment Channels** ialah: | Saluran | Pelanggan anda membayar dengan | |---|---| | **FPX (Online Banking)** | Online banking FPX | | **FPX Line of Credit** | Akaun kad kredit melalui FPX | | **DuitNow Online Banking/Wallets** | Online banking atau e-wallet DuitNow | | **DuitNow QR** | Mana-mana aplikasi perbankan atau e-wallet yang menyokong DuitNow QR | | **Credit Card** | Visa atau Mastercard | | **Boost PayFlex** | Boost PayFlex | | **QRIS (Online Banking)** | Online banking Indonesia | | **QRIS (E-Wallet)** | E-wallet Indonesia | | **NETS** | NETS (Singapura) | | **Alipay** | Alipay | | **WeChat Pay** | WeChat Pay | | **PromptPay** | PromptPay (Thailand) | Senarai itu juga memaparkan **FPX Direct Debit**. Itu ialah nama Direct Debit dalam plugin ini: pelanggan hanya menggunakan FPX untuk meluluskan, menukar atau menamatkan e-Mandate. Sesuatu saluran hanya berfungsi jika saluran itu juga di-on-kan untuk portal Bayarcash anda. Lihat [Saluran bayaran](/ms/payment-channels/). ## Sebelum anda mula Sediakan perkara ini sebelum anda menyediakan plugin: - Akaun merchant Bayarcash yang sudah diluluskan. - **Personal Access Token (PAT)**, **API Secret Key** dan **Portal Key** anda. Lihat [Cari API keys anda](/ms/api-keys/). - FluentCart yang sudah di-install dan aktif, dengan mata wang kedai ringgit Malaysia (MYR). ## Install plugin Plugin ini percuma di WordPress.org sebagai [Bayarcash for FluentCart](https://wordpress.org/plugins/bayarcash-for-fluentcart/). Untuk install plugin ini: 1. Dalam WordPress, pergi ke **Plugins** → **Add New**. 2. Cari **Bayarcash for FluentCart** dan klik **Install**. 3. Klik **Activate**. ## Sediakan Bayarcash Semua tetapan ada pada satu page: 1. Pergi ke **FluentCart** → **Settings** → **Payments** dan buka **Bayarcash**. 2. Paste token anda ke dalam **Personal Access Token (PAT)**. 3. Paste secret key anda ke dalam **API Secret Key**. 4. Paste portal key anda ke dalam **Portal Key**. 5. Dalam **Payment Channels**, tandakan saluran yang pelanggan anda boleh pilih. **FPX (Online Banking)** dan **DuitNow QR** sudah ditandakan secara default. 6. On-kan Bayarcash dan simpan. Apabila kedai anda dalam live mode, FluentCart memaparkan "Bayarcash gateway credentials verified successfully!" selepas anda simpan. Mesej ini hanya mengesahkan bahawa semua ruangan sudah diisi. Jadi, buat satu bayaran kecil untuk memastikan keys anda berfungsi. ## Tukar rupa checkout Page yang sama juga menetapkan rupa butang Bayarcash semasa checkout: | Tetapan | Apa yang berubah | |---|---| | **Bayarcash Checkout Theme** | **Light** atau **Dark** | | **Bayarcash Checkout Button Text** | Teks butang. Secara default, teksnya ialah "Pay with Bayarcash". | | **Bayarcash Checkout Button Color** dan **Bayarcash Checkout Button Hover Color** | Warna butang | | **Bayarcash Checkout Button Text Color** | Warna teks butang | | **Bayarcash Checkout Button Font Size** | Saiz teks, contohnya `16px` | ## Uji dalam sandbox Plugin ini tiada suis sandbox sendiri. Plugin ini mengikut mod kedai FluentCart anda: - **Test mode:** bayaran dihantar ke sandbox Bayarcash dengan test keys yang sudah ada dalam plugin. Keys yang anda masukkan tidak digunakan, dan FluentCart memaparkan "Bayarcash test mode is enabled with your credentials." semasa anda simpan. - **Live mode:** bayaran dihantar ke Bayarcash dengan keys yang anda masukkan. Tukar kedai anda kepada test mode, buat satu pesanan dan bayar di page sandbox. Apabila semuanya berfungsi, tukar kedai anda semula kepada live mode. Kemudian, buat satu bayaran sebenar yang kecil untuk menyemak keys anda sendiri. ## Cara Bayarcash menghantar keputusan bayaran ke kedai anda Anda tidak perlu paste callback URL ke dalam merchant dashboard. Plugin ini menghantar alamatnya sendiri bersama setiap bayaran. Bayarcash melaporkan keputusan bayaran ke laman web anda di `/?fluent-cart=fct_payment_listener_ipn&method=bayarcash`, dan pelanggan anda kembali ke page resit FluentCart anda. Kemudian, plugin ini menandakan pesanan itu sebagai sudah dibayar atau gagal. Plugin ini tidak akan menukar pesanan yang sudah dibayar atau sudah di-refund. Jika pesanan kekal pending walaupun bayaran berjaya, pastikan laman web anda boleh diakses oleh umum dan menggunakan HTTPS. Pastikan juga tiada firewall atau plugin keselamatan yang menyekat alamat itu. Lihat [Callback dan checksum](/ms/callbacks-and-checksum/). ## Tips Dua habit ini membantu anda dengan FluentCart: - **Tandakan hanya saluran yang portal anda boleh terima.** Pelanggan yang memilih saluran yang di-off-kan untuk portal anda tidak dapat membayar. - **Sentiasa buat satu ujian dengan keys live anda.** Test mode menggunakan keys plugin itu sendiri, jadi ujian itu tidak membuktikan keys anda betul. ## Isu biasa ### Kenapa saya nampak "Portal Key is required to activate the gateway." semasa menyimpan tetapan? FluentCart memerlukan ketiga-tiga keys sebelum mengaktifkan Bayarcash: Personal Access Token (PAT), API Secret Key dan Portal Key. Mesej yang sama dipaparkan untuk dua keys yang lain. Lihat Cari API keys anda (/ms/api-keys/). ### Kenapa checkout memaparkan "Bayarcash payment gateway is not properly configured"? Kedai anda dalam live mode, tetapi salah satu daripada tiga keys itu tiada. Buka FluentCart → Settings → Payments, buka Bayarcash, isi setiap key dan simpan. ### Kenapa bayaran masih gagal walaupun FluentCart memaparkan "Bayarcash gateway credentials verified successfully!"? Mesej itu hanya bermaksud ketiga-tiga ruangan sudah diisi. FluentCart tidak menyemak keys itu dengan Bayarcash. Copy setiap key sekali lagi dari merchant dashboard, dan pastikan portal anda boleh menerima saluran yang anda tandakan. Lihat Kenapa bayaran gagal (/ms/payment-failed/). ### Kenapa checkout memaparkan "Failed to create payment intent"? Bayarcash menolak request bayaran itu. Biasanya puncanya ialah key yang salah, atau saluran yang belum di-on-kan untuk portal anda. Semak keys anda dan Payment Channels yang anda tandakan. --- # 把FluentCart连接到Bayarcash > 安装Bayarcash for FluentCart,输入你的key,并选择顾客在结账时可以选用的Bayarcash付款渠道。 > > Source: https://docs.bayarcash.com/zh/fluentcart/ **Bayarcash for FluentCart**把Bayarcash加入你的FluentCart结账页面。顾客选择付款渠道,在Bayarcash页面付款,然后回到你的收据页面。 想在安装前先看看插件怎样运作,可以试试[在线演示](https://fluentcart.bayarcash-demo.com/)。 ## 支持的渠道 你可以选择顾客在结账时看到哪些渠道。**Payment Channels**里的选项如下: | 渠道 | 顾客用什么付款 | |---|---| | **FPX (Online Banking)** | FPX网上银行 | | **FPX Line of Credit** | 通过FPX使用信用卡账户 | | **DuitNow Online Banking/Wallets** | DuitNow网上银行或电子钱包 | | **DuitNow QR** | 任何支持DuitNow QR的银行App或电子钱包App | | **Credit Card** | Visa或Mastercard | | **Boost PayFlex** | Boost PayFlex | | **QRIS (Online Banking)** | 印尼网上银行 | | **QRIS (E-Wallet)** | 印尼电子钱包 | | **NETS** | NETS(新加坡) | | **Alipay** | Alipay | | **WeChat Pay** | WeChat Pay | | **PromptPay** | PromptPay(泰国) | 列表里也会显示**FPX Direct Debit**。这是插件对Direct Debit的叫法:顾客只在批准、修改或终止e-Mandate时使用FPX。渠道必须同时在你的Bayarcash portal开启,才能使用。请参阅[付款渠道](/zh/payment-channels/)。 ## 开始之前 设置插件之前,你需要准备好: - 已获批准的Bayarcash商家账号。 - 你的**Personal Access Token (PAT)**、**API Secret Key**和**Portal Key**。请参阅[找到你的API key](/zh/api-keys/)。 - 已安装并启用的FluentCart,商店货币设为马币(MYR)。 ## 安装插件 这个插件在WordPress.org免费提供,名称是[Bayarcash for FluentCart](https://wordpress.org/plugins/bayarcash-for-fluentcart/)。安装步骤: 1. 在WordPress,前往**Plugins** → **Add New**。 2. 搜索**Bayarcash for FluentCart**,然后点击**Install**。 3. 点击**Activate**。 ## 设置Bayarcash 所有设置都在同一个页面: 1. 前往**FluentCart** → **Settings** → **Payments**,然后打开**Bayarcash**。 2. 把你的token粘贴到**Personal Access Token (PAT)**。 3. 把你的key粘贴到**API Secret Key**。 4. 把你的portal key粘贴到**Portal Key**。 5. 在**Payment Channels**,勾选顾客可以选择的渠道。FPX (Online Banking)和**DuitNow QR**默认已勾选。 6. 开启Bayarcash,然后保存。 商店处于live mode时,保存后会显示“Bayarcash gateway credentials verified successfully!”。这只确认栏位都填了,所以请做一笔小额测试付款,确定key可以用。 ## 更改结账外观 同一个页面也可以设置Bayarcash按钮在结账时的外观: | 设置 | 它更改什么 | |---|---| | **Bayarcash Checkout Theme** | **Light**或**Dark** | | **Bayarcash Checkout Button Text** | 按钮文字。默认是“Pay with Bayarcash”。 | | **Bayarcash Checkout Button Color**和**Bayarcash Checkout Button Hover Color** | 按钮颜色 | | **Bayarcash Checkout Button Text Color** | 按钮文字的颜色 | | **Bayarcash Checkout Button Font Size** | 文字大小,例如`16px` | ## 在sandbox测试 插件本身没有sandbox开关,它跟随你的FluentCart商店模式: - **Test mode**:付款会转到Bayarcash sandbox,使用插件内置的测试key。你输入的key不会被使用,保存时会显示“Bayarcash test mode is enabled with your credentials.”。 - **Live mode**:付款会转到Bayarcash,使用你输入的key。 把商店切换到test mode,下一个订单,然后在sandbox页面付款。测试成功后,把商店切换回live mode,再做一笔小额真实付款,检查你自己的key。 ## 付款结果怎样传到你的商店 你不需要把callback URL粘贴到商家后台(merchant dashboard)。插件每次付款时都会发送它自己的地址:Bayarcash把付款结果报告到你网站的`/?fluent-cart=fct_payment_listener_ipn&method=bayarcash`,顾客则回到你的FluentCart收据页面。插件随后把订单标为已付款或失败。已付款或已退款的订单,插件不会更改。 如果付款成功后订单还是待处理,请确认你的网站是公开的、使用HTTPS,而且没有防火墙或安全插件拦截这个地址。请参阅[Callback和checksum](/zh/callbacks-and-checksum/)。 ## 小贴士 使用FluentCart时,这两个习惯对你有帮助: - **只勾选你的portal可以接受的渠道**。顾客如果选了没有为你的portal开启的渠道,就无法付款。 - **一定要用你的正式key测试一次**。Test mode使用插件自己的key,所以不能证明你的key是正确的。 ## 常见问题 ### 保存设置时显示“Portal Key is required to activate the gateway.”,为什么? FluentCart要三个key都填好,才会开启Bayarcash:Personal Access Token (PAT)、API Secret Key和Portal Key。另外两个key缺少时,也会显示同样的信息。请参阅找到你的API key (/zh/api-keys/)。 ### 结账页面显示“Bayarcash payment gateway is not properly configured”,为什么? 你的商店处于live mode,但三个key中少了一个。打开FluentCart → Settings → Payments,打开Bayarcash,填好每个key,然后保存。 ### 保存时显示“Bayarcash gateway credentials verified successfully!”,但付款还是失败,为什么? 这个信息只表示三个栏位都填了,它不会向Bayarcash核对这些key。从商家后台(merchant dashboard)重新复制每个key,并确认你的portal可以接受你勾选的渠道。请参阅为什么我的付款失败? (/zh/payment-failed/)。 ### 结账页面显示“Failed to create payment intent”,为什么? Bayarcash拒绝了这个付款request,通常是因为key错误,或你勾选的渠道没有为你的portal开启。检查你的key和你勾选的Payment Channels。 --- # Connect Easy Digital Downloads to Bayarcash > Install Bayarcash for Easy Digital Downloads, enter your keys and choose which Bayarcash payment methods your buyers see at checkout. > > Source: https://docs.bayarcash.com/easy-digital-downloads/ **Bayarcash for Easy Digital Downloads** adds Bayarcash to your EDD checkout. Your buyer picks a payment method, pays on the Bayarcash page and comes back to your purchase confirmation page. To see the plugin at work before you install it, try the [live demo](https://edd.bayarcash-demo.com/). ## What it supports You choose which methods your buyers see at checkout. The options in **Payment Methods** are: | Payment method | What your buyer pays with | |---|---| | **FPX Online Banking** | FPX online banking | | **FPX Line of Credit** | A credit card account through FPX | | **DuitNow Online Banking/Wallets** | DuitNow online banking or e-wallet | | **DuitNow QR** | Any DuitNow QR banking or e-wallet app | | **Credit Card** | Visa or Mastercard | | **Touch n Go** | Touch 'n Go eWallet | | **Boost Wallet** and **Boost PayFlex** | Boost e-wallet, or Boost's pay later | | **GrabPay** and **Grab PayLater** | GrabPay, or PayLater by Grab | | **ShopeePay** | ShopeePay | | **QRIS Online Banking** and **QRIS Wallet** | Indonesian online banking or e-wallets | | **NETS** | NETS (Singapore) | | **Alipay**, **WeChat Pay** and **PromptPay** | Alipay, WeChat Pay or PromptPay (Thailand) | Payments are one-off. A method only works if it is also turned on for your Bayarcash portal. See [Payment channels](/payment-channels/). ## Before you start You need these before you set up the plugin: - An approved Bayarcash merchant account. - Your **Personal Access Token (PAT)**, **API Secret Key** and **Portal Key**. See [Find your API keys](/api-keys/). - Easy Digital Downloads installed and active, with the currency set to Malaysian ringgit (MYR) and a success page set in the EDD page settings. ## Install the plugin The plugin is free on WordPress.org as [Bayarcash For Easy Digital Downloads](https://wordpress.org/plugins/bayarcash-for-easy-digital-downloads/). To install it: 1. In WordPress, go to **Plugins** → **Add New**. 2. Search for **Bayarcash for Easy Digital Downloads** and click **Install**. 3. Click **Activate**. ## Enter your keys The plugin names your keys a little differently from the merchant dashboard: **Token** is your Personal Access Token (PAT), and **Secret Key** is your API Secret Key. 1. Go to **Downloads** → **Settings** → **Payments** and open the **Bayarcash** section. 2. Paste your Personal Access Token into **Token**. The plugin checks it and shows "PAT Token is valid". You can also click **Verify Token**. 3. Paste your API Secret Key into **Secret Key**. 4. Choose your portal in **Portal Key**. The list fills in once the token is valid. 5. In **Payment Methods**, tick the methods your buyers can choose. 6. Save. ## Turn on the gateway The keys alone do not show Bayarcash at checkout. Turn it on in EDD too: 1. In **Downloads** → **Settings** → **Payments**, open EDD's list of payment gateways. 2. Tick **Bayarcash**. 3. Save. Buyers see it at checkout as **Pay with Bayarcash**, with a list of the methods you ticked. ## Test in sandbox The plugin follows EDD's test mode, and swaps in its own test keys: - **Test mode on:** payments go to the Bayarcash sandbox, using test keys built into the plugin. The keys you entered are not used. - **Test mode off:** payments go to Bayarcash using your own keys. Turn on EDD's test mode, buy a product and pay it on the sandbox page. When it works, turn test mode off and make one small real payment to check your own keys. ## How payment results reach your store You do not paste a callback URL into the merchant dashboard. After paying, your buyer returns to your EDD success page. The plugin then asks Bayarcash for the payment result every minute and updates the order, adding an order note each time the status changes. This check runs on WP-Cron, so your site must be public and WP-Cron must run. See [Callbacks and checksum](/callbacks-and-checksum/). ## Tips Two habits help with Easy Digital Downloads: - **Always test once with your live keys.** Test mode uses the plugin's own keys, so it does not prove your keys are right. - **Turn on Debug Mode while you set up.** It writes `[Bayarcash]` lines to the EDD logs, which show exactly why a payment failed. ## Common issues ### WordPress shows "Bayarcash gateway is active but not fully configured." What is missing? One of Token, Secret Key or Portal Key is empty. Fill in all three in the Bayarcash section of the EDD payment settings and save. See Find your API keys (/api-keys/). ### Buyers see "No payment methods available." at checkout. No box is ticked in Payment Methods. Tick at least one method and save. ### Buyers see "Payment error:" followed by a message from Bayarcash. Bayarcash refused the payment request. Common causes are a wrong key, or a payment method that is not turned on for your portal. Turn on Debug Mode, try again and read the [Bayarcash] lines in the EDD logs. See Why a payment failed (/payment-failed/). ### The buyer paid, but the order is still pending. Why? The plugin confirms payments by asking Bayarcash every minute through WP-Cron. If your site has little traffic or WP-Cron is off, set up a real cron job so the check runs on time. --- # Sambungkan Easy Digital Downloads kepada Bayarcash > Install Bayarcash for Easy Digital Downloads, masukkan keys anda dan pilih kaedah bayaran Bayarcash yang pembeli nampak semasa checkout. > > Source: https://docs.bayarcash.com/ms/easy-digital-downloads/ **Bayarcash for Easy Digital Downloads** menambah Bayarcash pada checkout EDD anda. Pembeli anda memilih kaedah bayaran, membuat bayaran di page Bayarcash, dan kemudian kembali ke page pengesahan pembelian anda. Untuk melihat plugin ini berfungsi sebelum anda install, cuba [demo langsung](https://edd.bayarcash-demo.com/). ## Kaedah bayaran yang disokong Anda pilih kaedah yang pembeli nampak semasa checkout. Pilihan dalam **Payment Methods** ialah: | Kaedah bayaran | Pembeli anda membayar dengan | |---|---| | **FPX Online Banking** | Online banking FPX | | **FPX Line of Credit** | Akaun kad kredit melalui FPX | | **DuitNow Online Banking/Wallets** | Online banking atau e-wallet DuitNow | | **DuitNow QR** | Mana-mana aplikasi perbankan atau e-wallet yang menyokong DuitNow QR | | **Credit Card** | Visa atau Mastercard | | **Touch n Go** | Touch 'n Go eWallet | | **Boost Wallet** dan **Boost PayFlex** | E-wallet Boost, atau pay later daripada Boost | | **GrabPay** dan **Grab PayLater** | GrabPay, atau PayLater daripada Grab | | **ShopeePay** | ShopeePay | | **QRIS Online Banking** dan **QRIS Wallet** | Online banking atau e-wallet Indonesia | | **NETS** | NETS (Singapura) | | **Alipay**, **WeChat Pay** dan **PromptPay** | Alipay, WeChat Pay atau PromptPay (Thailand) | Bayaran dibuat sekali sahaja. Sesuatu kaedah hanya berfungsi jika kaedah itu juga di-on-kan untuk portal Bayarcash anda. Lihat [Saluran bayaran](/ms/payment-channels/). ## Sebelum anda mula Sediakan perkara ini sebelum anda menyediakan plugin: - Akaun merchant Bayarcash yang sudah diluluskan. - **Personal Access Token (PAT)**, **API Secret Key** dan **Portal Key** anda. Lihat [Cari API keys anda](/ms/api-keys/). - Easy Digital Downloads yang sudah di-install dan aktif. Mata wang mesti ringgit Malaysia (MYR), dan page pembelian berjaya mesti sudah ditetapkan dalam tetapan page EDD. ## Install plugin Plugin ini percuma di WordPress.org sebagai [Bayarcash For Easy Digital Downloads](https://wordpress.org/plugins/bayarcash-for-easy-digital-downloads/). Untuk install plugin ini: 1. Dalam WordPress, pergi ke **Plugins** → **Add New**. 2. Cari **Bayarcash for Easy Digital Downloads** dan klik **Install**. 3. Klik **Activate**. ## Masukkan keys anda Nama keys dalam plugin ini sedikit berbeza daripada nama dalam merchant dashboard. **Token** ialah Personal Access Token (PAT) anda, dan **Secret Key** ialah API Secret Key anda. 1. Pergi ke **Downloads** → **Settings** → **Payments** dan buka bahagian **Bayarcash**. 2. Paste Personal Access Token anda ke dalam **Token**. Plugin ini menyemak token itu dan memaparkan "PAT Token is valid". Anda juga boleh klik **Verify Token**. 3. Paste API Secret Key anda ke dalam **Secret Key**. 4. Pilih portal anda dalam **Portal Key**. Senarai portal dipaparkan selepas token itu sah. 5. Dalam **Payment Methods**, tandakan kaedah yang pembeli anda boleh pilih. 6. Simpan. ## On-kan gateway Bayarcash Keys sahaja tidak memaparkan Bayarcash semasa checkout. Anda juga perlu on-kan Bayarcash dalam EDD: 1. Dalam **Downloads** → **Settings** → **Payments**, buka senarai payment gateway EDD. 2. Tandakan **Bayarcash**. 3. Simpan. Semasa checkout, pembeli nampak Bayarcash sebagai **Pay with Bayarcash**, dengan senarai kaedah yang anda tandakan. ## Uji dalam sandbox Plugin ini mengikut test mode EDD, dan menggunakan test keys sendiri: - **Test mode on:** bayaran dihantar ke sandbox Bayarcash dengan test keys yang sudah ada dalam plugin. Keys yang anda masukkan tidak digunakan. - **Test mode off:** bayaran dihantar ke Bayarcash dengan keys anda sendiri. On-kan test mode EDD, beli satu produk dan bayar di page sandbox. Apabila semuanya berfungsi, off-kan test mode. Kemudian, buat satu bayaran sebenar yang kecil untuk menyemak keys anda sendiri. ## Cara keputusan bayaran dikemas kini di kedai anda Anda tidak perlu paste callback URL ke dalam merchant dashboard. Selepas membayar, pembeli anda kembali ke page pembelian berjaya EDD anda. Kemudian, plugin ini menyemak keputusan bayaran di Bayarcash setiap minit dan mengemas kini pesanan itu. Setiap kali status berubah, plugin ini menambah nota pada pesanan. Semakan ini berjalan melalui WP-Cron. Jadi, laman web anda mesti boleh diakses oleh umum dan WP-Cron mesti berjalan. Lihat [Callback dan checksum](/ms/callbacks-and-checksum/). ## Tips Dua habit ini membantu anda dengan Easy Digital Downloads: - **Sentiasa buat satu ujian dengan keys live anda.** Test mode menggunakan keys plugin itu sendiri, jadi ujian itu tidak membuktikan keys anda betul. - **On-kan Debug Mode semasa anda menyediakan plugin.** Debug Mode menulis baris `[Bayarcash]` dalam log EDD. Baris itu menunjukkan dengan tepat kenapa sesuatu bayaran gagal. ## Isu biasa ### Kenapa WordPress memaparkan "Bayarcash gateway is active but not fully configured."? Salah satu daripada Token, Secret Key atau Portal Key masih kosong. Isi ketiga-tiganya di bahagian Bayarcash dalam tetapan bayaran EDD dan simpan. Lihat Cari API keys anda (/ms/api-keys/). ### Kenapa pembeli nampak "No payment methods available." semasa checkout? Tiada kotak yang ditandakan dalam Payment Methods. Tandakan sekurang-kurangnya satu kaedah dan simpan. ### Kenapa pembeli nampak "Payment error:" diikuti mesej daripada Bayarcash? Bayarcash menolak request bayaran itu. Punca biasa ialah key yang salah, atau kaedah bayaran yang belum di-on-kan untuk portal anda. On-kan Debug Mode, cuba sekali lagi dan baca baris [Bayarcash] dalam log EDD. Lihat Kenapa bayaran gagal (/ms/payment-failed/). ### Kenapa pesanan masih pending walaupun pembeli sudah membayar? Plugin ini mengesahkan bayaran dengan menyemak status di Bayarcash setiap minit melalui WP-Cron. Jika laman web anda kurang trafik atau WP-Cron di-off-kan, sediakan cron job sebenar supaya semakan itu berjalan tepat pada masanya. --- # 把Easy Digital Downloads连接到Bayarcash > 安装Bayarcash for Easy Digital Downloads,输入你的key,并选择买家在结账时看到的Bayarcash付款方式。 > > Source: https://docs.bayarcash.com/zh/easy-digital-downloads/ **Bayarcash for Easy Digital Downloads**把Bayarcash加入你的EDD结账页面。买家选择付款方式,在Bayarcash页面付款,然后回到你的购买确认页面。 想在安装前先看看插件怎样运作,可以试试[在线演示](https://edd.bayarcash-demo.com/)。 ## 支持的付款方式 你可以选择买家在结账时看到哪些付款方式。**Payment Methods**里的选项如下: | 付款方式 | 买家用什么付款 | |---|---| | **FPX Online Banking** | FPX网上银行 | | **FPX Line of Credit** | 通过FPX使用信用卡账户 | | **DuitNow Online Banking/Wallets** | DuitNow网上银行或电子钱包 | | **DuitNow QR** | 任何支持DuitNow QR的银行App或电子钱包App | | **Credit Card** | Visa或Mastercard | | **Touch n Go** | Touch 'n Go eWallet | | **Boost Wallet**和**Boost PayFlex** | Boost电子钱包,或Boost的先买后付 | | **GrabPay**和**Grab PayLater** | GrabPay,或Grab的PayLater | | **ShopeePay** | ShopeePay | | **QRIS Online Banking**和**QRIS Wallet** | 印尼网上银行或电子钱包 | | **NETS** | NETS(新加坡) | | **Alipay**、**WeChat Pay**和**PromptPay** | Alipay、WeChat Pay或PromptPay(泰国) | 付款都是一次性的。付款方式必须同时在你的Bayarcash portal开启,才能使用。请参阅[付款渠道](/zh/payment-channels/)。 ## 开始之前 设置插件之前,你需要准备好: - 已获批准的Bayarcash商家账号。 - 你的**Personal Access Token (PAT)**、**API Secret Key**和**Portal Key**。请参阅[找到你的API key](/zh/api-keys/)。 - 已安装并启用的Easy Digital Downloads,货币设为马币(MYR),并在EDD的页面设置里设好付款成功页面。 ## 安装插件 这个插件在WordPress.org免费提供,名称是[Bayarcash For Easy Digital Downloads](https://wordpress.org/plugins/bayarcash-for-easy-digital-downloads/)。安装步骤: 1. 在WordPress,前往**Plugins** → **Add New**。 2. 搜索**Bayarcash for Easy Digital Downloads**,然后点击**Install**。 3. 点击**Activate**。 ## 输入你的key 插件里key的名称和商家后台(merchant dashboard)稍有不同:**Token**就是你的Personal Access Token(PAT),**Secret Key**就是你的API Secret Key。 1. 前往**Downloads** → **Settings** → **Payments**,然后打开**Bayarcash**部分。 2. 把你的Personal Access Token粘贴到**Token**。插件会检查它,并显示“PAT Token is valid”。你也可以点击**Verify Token**。 3. 把你的API Secret Key粘贴到**Secret Key**。 4. 在**Portal Key**选择你的portal。token有效后,列表才会出现选项。 5. 在**Payment Methods**,勾选买家可以选择的付款方式。 6. 保存。 ## 开启支付网关 只填好key,结账时还不会显示Bayarcash。你也要在EDD开启它: 1. 在**Downloads** → **Settings** → **Payments**,打开EDD的支付网关列表。 2. 勾选**Bayarcash**。 3. 保存。 买家在结账时会看到**Pay with Bayarcash**,下面列出你勾选的付款方式。 ## 在sandbox测试 插件跟随EDD的测试模式,并换上它自己的测试key: - **Test mode on**:付款会转到Bayarcash sandbox,使用插件内置的测试key。你输入的key不会被使用。 - **Test mode off**:付款会转到Bayarcash,使用你自己的key。 开启EDD的测试模式,购买一件产品,然后在sandbox页面付款。测试成功后,关闭测试模式,再做一笔小额真实付款,检查你自己的key。 ## 付款结果怎样传到你的商店 你不需要把callback URL粘贴到商家后台。买家付款后,会回到你的EDD付款成功页面。插件随后每分钟向Bayarcash查询付款结果并更新订单,每次状态改变都会添加一条订单备注。 这个查询靠WP-Cron运行,所以你的网站必须是公开的,而且WP-Cron必须在运行。请参阅[Callback和checksum](/zh/callbacks-and-checksum/)。 ## 小贴士 使用Easy Digital Downloads时,这两个习惯对你有帮助: - **一定要用你的正式key测试一次**。测试模式使用插件自己的key,所以不能证明你的key是正确的。 - **设置期间开启Debug Mode**。它会把`[Bayarcash]`记录写入EDD日志,清楚显示付款失败的原因。 ## 常见问题 ### WordPress显示“Bayarcash gateway is active but not fully configured.”,少了什么? Token、Secret Key或Portal Key其中一个是空的。在EDD付款设置的Bayarcash部分填好这三项,然后保存。请参阅找到你的API key (/zh/api-keys/)。 ### 买家在结账时看到“No payment methods available.”,为什么? Payment Methods里没有勾选任何方框。至少勾选一种付款方式,然后保存。 ### 买家看到“Payment error:”,后面跟着Bayarcash的信息,为什么? Bayarcash拒绝了这个付款request。常见原因是key错误,或付款方式没有为你的portal开启。开启Debug Mode,再试一次,然后查看EDD日志里的[Bayarcash]记录。请参阅为什么我的付款失败? (/zh/payment-failed/)。 ### 买家已经付款,但订单还是待处理,为什么? 插件通过WP-Cron每分钟向Bayarcash查询,以确认付款。如果你的网站流量很少,或WP-Cron已关闭,请设置一个真正的cron job,让查询准时运行。 --- # Connect Gravity Forms to Bayarcash > Install Bayarcash for Gravity Forms, enter your keys and add a Bayarcash feed so your forms take FPX, DuitNow and other payments. > > Source: https://docs.bayarcash.com/gravity-forms/ **Bayarcash for Gravity Forms** adds Bayarcash to your Gravity Forms payment forms. Your customer fills in the form, picks a payment method, pays on the Bayarcash page and comes back to your form's confirmation. To see the plugin at work before you install it, try the [live demo](https://form.bayarcash-demo.com/gravityforms/). ## What it supports You choose which channels your customers see. The options in **Payment Channels** are: | Channel | What your customer pays with | |---|---| | FPX Online Banking | FPX online banking | | Credit/Debit Card | A credit card account through FPX | | DuitNow Online Banking | DuitNow Online Banking/Wallets | | DuitNow QR | Any DuitNow QR banking or e-wallet app | | ShopeePayLater | SPayLater by Shopee | | Boost PayFlex | Boost PayFlex | | Indonesia Online Banking | Indonesian online banking (QRIS) | | Indonesia E-Wallet | Indonesian e-wallets (QRIS) | | NETS Singapore | NETS (Singapore) | Payments are one-off and in MYR only. Subscriptions and Direct Debit are not supported. A channel only works if it is also turned on for your Bayarcash portal. See [Payment channels](/payment-channels/). ## Before you start You need these before you set up the plugin: - An approved Bayarcash merchant account. - Your **Personal Access Token (PAT)**, **API Secret Key** and **Portal Key**. See [Find your API keys](/api-keys/). - Gravity Forms installed and active, with the currency set to Malaysian ringgit (MYR). ## Install the plugin The plugin is listed on WordPress.org as [Bayarcash for Gravity Forms](https://wordpress.org/plugins/bayarcash-for-gravity-forms/). To install it: 1. In WordPress, go to **Plugins** → **Add New**. 2. Search for **Bayarcash for Gravity Forms** and click **Install**. 3. Click **Activate**. > **Note** > This guide follows version 2 of the plugin. If your Bayarcash settings page has only **Personal Access Token (PAT)** and **Portal Key**, with no **API Secret Key** or **Payment Channels**, you have an older version. Ask Bayarcash support for the latest one. ## Enter your keys Keys on the global settings page are used by every form that does not set its own: 1. Go to **Forms** → **Settings** → **Bayarcash**. 2. Paste your token into **Personal Access Token (PAT)** and click **Verify Token**. It shows "Token verified successfully!" when the token works. 3. Click **View Portal** and pick your portal from **Available Portals**. The plugin fills in **Portal Key** for you. 4. Paste your key into **API Secret Key**. 5. In **Payment Channels**, clear the channels you do not want. All are ticked to start with. 6. Leave **Enable Sandbox Mode** cleared for real payments. 7. Save. ## Add Bayarcash to a form Each form that takes payments needs a Bayarcash feed. The form also needs a product or total field, and fields for the customer's name and email. 1. Open the form and go to **Settings** → **Bayarcash**, then add a new feed. 2. Give the feed a name. 3. In **Configuration Type**, choose **Global Configuration** to use the keys from the settings page. To use a different account or portal for this form only, choose **Form Configuration** and fill in the keys, channels and sandbox setting that appear. 4. Choose the transaction type and the payment amount. 5. Under **Client Information.**, map **Email** and **Full Name** to your form fields. **Phone Number** is optional. 6. Optional: map **Purhase Description** (spelt that way in the plugin) to a field whose text goes with the payment. 7. Optional: set a **Cancel URL**, the page your customer goes to if they cancel. Left blank, they go back to the form. 8. Save the feed. When the form loads, your customer sees **Select Payment Method** with the channels you ticked. You can send emails on the **Payment Completed** and **Payment Failed** notification events. ## Test in sandbox When **Enable Sandbox Mode** is ticked, payments go to the Bayarcash sandbox using test keys built into the plugin. The keys you entered are not used for the payment. 1. Tick **Enable Sandbox Mode** and save. 2. Submit your form and pay on the sandbox page. 3. When it works, clear **Enable Sandbox Mode**, save, and make one small real payment to check your own keys. A feed set to **Form Configuration** has its own **Enable Sandbox Mode** box. Check it too. ## How payment results reach your site You do not paste a callback URL into the merchant dashboard. The plugin sends its own address with each payment, on your site at `/?callback=bayarcash-for-gravity-forms`, and Bayarcash sends the result there. The plugin marks the entry paid, pending or failed, and adds a note to the entry. If entries stay pending after a successful payment, make sure your site is public, uses HTTPS, and that no firewall or security plugin blocks that address. See [Callbacks and checksum](/callbacks-and-checksum/). ## Tips Two habits help with Gravity Forms: - **Always test once with your live keys.** Sandbox mode uses the plugin's own keys, so it does not prove your keys are right. - **Use Form Configuration for separate campaigns.** A different portal per form keeps each campaign's payments apart in your Bayarcash reports. ## Common issues ### My form shows "Required fields (email and name) must be mapped in the feed settings." Open the form's Bayarcash feed and, under Client Information., map Email and Full Name to fields on your form. Both are required. ### My form shows "Global Bayarcash settings are not properly configured." The feed uses Global Configuration, but a key is missing on the global settings page. Go to Forms → Settings → Bayarcash and fill in Personal Access Token (PAT), Portal Key and API Secret Key. If the message says "Form-specific" instead, fill in the keys on the feed. ### Customers see "Payment gateway error. Please try again later." What happened? Bayarcash refused the payment request, and the entry was not kept. Check your keys, and that the channels you ticked are turned on for your portal. See Why a payment failed (/payment-failed/). ### WordPress says required dependencies are missing and asks me to run composer install. What do I do? The plugin files are incomplete. Delete the plugin and install it again from a complete copy supplied by Bayarcash. --- # Sambungkan Gravity Forms kepada Bayarcash > Install Bayarcash for Gravity Forms, masukkan keys anda dan tambah feed Bayarcash supaya form anda terima bayaran FPX, DuitNow dan lain-lain. > > Source: https://docs.bayarcash.com/ms/gravity-forms/ **Bayarcash for Gravity Forms** menambah Bayarcash pada payment form Gravity Forms anda. Pelanggan anda mengisi form, memilih kaedah bayaran dan membayar di page Bayarcash. Kemudian pelanggan kembali ke page pengesahan form anda. Untuk melihat plugin ini berfungsi sebelum anda install, cuba [demo langsung](https://form.bayarcash-demo.com/gravityforms/). ## Saluran yang disokong Anda pilih saluran yang pelanggan anda nampak. Pilihan dalam **Payment Channels** ialah: | Saluran | Cara pelanggan anda membayar | |---|---| | FPX Online Banking | Perbankan online FPX | | Credit/Debit Card | Akaun kad kredit melalui FPX | | DuitNow Online Banking | DuitNow Online Banking/Wallets | | DuitNow QR | Mana-mana aplikasi bank atau e-wallet yang menyokong DuitNow QR | | ShopeePayLater | SPayLater by Shopee | | Boost PayFlex | Boost PayFlex | | Indonesia Online Banking | Perbankan online Indonesia (QRIS) | | Indonesia E-Wallet | E-wallet Indonesia (QRIS) | | NETS Singapore | NETS (Singapura) | Plugin ini hanya menerima bayaran sekali sahaja, dalam MYR. Plugin ini tidak menyokong langganan dan Direct Debit. Sesuatu saluran hanya berfungsi jika saluran itu juga di-on-kan untuk portal Bayarcash anda. Lihat [Saluran bayaran](/ms/payment-channels/). ## Sebelum anda mula Anda memerlukan perkara ini sebelum anda sediakan plugin: - Akaun merchant Bayarcash yang sudah diluluskan. - **Personal Access Token (PAT)**, **API Secret Key** dan **Portal Key** anda. Lihat [Cari API keys anda](/ms/api-keys/). - Gravity Forms yang sudah di-install dan aktif. Mata wang mesti ringgit Malaysia (MYR). ## Install plugin Plugin ini tersenarai di WordPress.org dengan nama [Bayarcash for Gravity Forms](https://wordpress.org/plugins/bayarcash-for-gravity-forms/). Untuk install plugin ini: 1. Dalam WordPress, pergi ke **Plugins** → **Add New**. 2. Cari **Bayarcash for Gravity Forms** dan klik **Install**. 3. Klik **Activate**. > **Note** > Panduan ini mengikut versi 2 plugin. Jika page tetapan Bayarcash anda hanya ada **Personal Access Token (PAT)** dan **Portal Key**, tanpa **API Secret Key** atau **Payment Channels**, anda menggunakan versi lama. Minta versi terkini daripada team Bayarcash. ## Masukkan keys anda Setiap form yang tidak menetapkan keys sendiri akan menggunakan keys pada page tetapan global: 1. Pergi ke **Forms** → **Settings** → **Bayarcash**. 2. Paste token anda ke dalam **Personal Access Token (PAT)** dan klik **Verify Token**. Plugin memaparkan "Token verified successfully!" apabila token itu berfungsi. 3. Klik **View Portal** dan pilih portal anda dari **Available Portals**. Plugin mengisi **Portal Key** untuk anda. 4. Paste key anda ke dalam **API Secret Key**. 5. Dalam **Payment Channels**, buang tanda pada saluran yang anda tidak mahu. Semua saluran ditandakan pada mulanya. 6. Untuk bayaran sebenar, jangan tandakan **Enable Sandbox Mode**. 7. Simpan. ## Tambah Bayarcash pada form Setiap form yang menerima bayaran memerlukan feed Bayarcash. Form itu juga memerlukan ruangan produk atau jumlah, serta ruangan untuk nama dan e-mel pelanggan. 1. Buka form itu dan pergi ke **Settings** → **Bayarcash**, kemudian tambah feed baru. 2. Beri nama untuk feed itu. 3. Dalam **Configuration Type**, pilih **Global Configuration** untuk menggunakan keys dari page tetapan. Untuk menggunakan akaun atau portal lain bagi form ini sahaja, pilih **Form Configuration**. Kemudian isi keys, saluran dan tetapan sandbox yang dipaparkan. 4. Pilih jenis transaksi dan amaun bayaran. 5. Di bawah **Client Information.**, padankan **Email** dan **Full Name** dengan ruangan form anda. **Phone Number** tidak wajib. 6. Pilihan: padankan **Purhase Description** (ejaan ini memang begitu dalam plugin) dengan ruangan yang teksnya dihantar bersama bayaran. 7. Pilihan: tetapkan **Cancel URL**, iaitu page yang pelanggan pergi jika mereka batalkan bayaran. Jika kosong, pelanggan kembali ke form. 8. Simpan feed itu. Apabila form dibuka, pelanggan anda nampak **Select Payment Method** dengan saluran yang anda tandakan. Anda boleh hantar e-mel pada notification event **Payment Completed** dan **Payment Failed**. ## Uji dalam sandbox Apabila **Enable Sandbox Mode** ditandakan, bayaran pergi ke sandbox Bayarcash dengan test keys yang sudah ada dalam plugin. Plugin tidak menggunakan keys yang anda masukkan untuk bayaran itu. 1. Tandakan **Enable Sandbox Mode** dan simpan. 2. Hantar form anda dan bayar di page sandbox. 3. Apabila semuanya berfungsi, buang tanda **Enable Sandbox Mode** dan simpan. Kemudian buat satu bayaran sebenar yang kecil untuk menyemak keys anda sendiri. Feed yang ditetapkan kepada **Form Configuration** ada kotak **Enable Sandbox Mode** sendiri. Semak kotak itu juga. ## Cara keputusan bayaran sampai ke laman web anda Anda tidak perlu paste URL callback ke dalam merchant dashboard. Plugin ini menghantar alamat sendiri bersama setiap bayaran, iaitu `/?callback=bayarcash-for-gravity-forms` pada laman web anda, dan Bayarcash menghantar keputusan ke alamat itu. Plugin menandakan entry itu sebagai paid, pending atau failed, dan menambah nota pada entry itu. Jika entry kekal pending selepas bayaran berjaya, pastikan laman web anda terbuka kepada umum dan menggunakan HTTPS. Pastikan juga tiada firewall atau plugin keselamatan yang menyekat alamat itu. Lihat [Callback dan checksum](/ms/callbacks-and-checksum/). ## Tips Dua habit ini membantu anda dengan Gravity Forms: - **Sentiasa uji sekali dengan keys live anda.** Sandbox mode menggunakan keys plugin itu sendiri, jadi ujian sandbox tidak membuktikan keys anda betul. - **Guna Form Configuration untuk kempen yang berasingan.** Portal yang berbeza bagi setiap form memisahkan bayaran setiap kempen dalam laporan Bayarcash anda. ## Isu biasa ### Kenapa form saya memaparkan "Required fields (email and name) must be mapped in the feed settings."? Buka feed Bayarcash form itu. Di bawah Client Information., padankan Email dan Full Name dengan ruangan pada form anda. Kedua-duanya wajib. ### Kenapa form saya memaparkan "Global Bayarcash settings are not properly configured."? Feed itu menggunakan Global Configuration, tetapi satu key tiada pada page tetapan global. Pergi ke Forms → Settings → Bayarcash dan isi Personal Access Token (PAT), Portal Key dan API Secret Key. Jika mesej itu menyebut "Form-specific", isi keys pada feed itu. ### Kenapa pelanggan nampak "Payment gateway error. Please try again later."? Bayarcash menolak request bayaran itu, dan entry itu tidak disimpan. Semak keys anda. Pastikan juga saluran yang anda tandakan sudah di-on-kan untuk portal anda. Lihat Kenapa bayaran saya gagal? (/ms/payment-failed/). ### WordPress menyatakan ada dependencies yang tiada dan meminta saya run composer install. Apa yang saya perlu buat? Fail plugin itu tidak lengkap. Delete plugin itu dan install semula dari salinan lengkap yang Bayarcash berikan. --- # 把Gravity Forms连接到Bayarcash > 安装Bayarcash for Gravity Forms,输入你的key并添加Bayarcash feed,让表单收取FPX、DuitNow等付款。 > > Source: https://docs.bayarcash.com/zh/gravity-forms/ **Bayarcash for Gravity Forms**把Bayarcash加入你的Gravity Forms付款表单。你的顾客填写表单,选择付款方式,在Bayarcash页面付款,然后回到你表单的确认页面。 安装之前想先看看插件怎样运作,可以试试[在线演示](https://form.bayarcash-demo.com/gravityforms/)。 ## 支持的渠道 你可以选择顾客看到哪些渠道。**Payment Channels**里的选项有: | 渠道 | 你的顾客用什么付款 | |---|---| | FPX Online Banking | FPX网上银行 | | Credit/Debit Card | 通过FPX使用信用卡账户 | | DuitNow Online Banking | DuitNow Online Banking/Wallets | | DuitNow QR | 任何支持DuitNow QR的银行或电子钱包App | | ShopeePayLater | Shopee的SPayLater | | Boost PayFlex | Boost PayFlex | | Indonesia Online Banking | 印尼网上银行(QRIS) | | Indonesia E-Wallet | 印尼电子钱包(QRIS) | | NETS Singapore | NETS(新加坡) | 付款只限一次性付款,而且只接受MYR。不支持订阅和Direct Debit。一个渠道必须同时在你的Bayarcash portal开启,才能使用。请参阅[付款渠道](/zh/payment-channels/)。 ## 开始之前 设置插件之前,你需要准备好这些: - 一个已获批准的Bayarcash商家账号。 - 你的**Personal Access Token (PAT)**、**API Secret Key**和**Portal Key**。请参阅[找到你的API key](/zh/api-keys/)。 - 已安装并启用的Gravity Forms,货币设为马来西亚令吉(MYR)。 ## 安装插件 这个插件已上架WordPress.org,名称是[Bayarcash for Gravity Forms](https://wordpress.org/plugins/bayarcash-for-gravity-forms/)。安装步骤: 1. 在WordPress里,前往**Plugins** → **Add New**。 2. 搜索**Bayarcash for Gravity Forms**,然后点击**Install**。 3. 点击**Activate**。 > **Note** > 本指南以插件第2版为准。如果你的Bayarcash设置页面只有Personal Access Token (PAT)和**Portal Key**,没有**API Secret Key**或**Payment Channels**,表示你用的是旧版本。请向Bayarcash支持团队索取最新版本。 ## 输入你的key 没有自己设置key的表单,都会使用全局设置页面里的key: 1. 前往**Forms** → **Settings** → **Bayarcash**。 2. 把你的token粘贴到**Personal Access Token (PAT)**,然后点击**Verify Token**。token有效时,会显示“Token verified successfully!”。 3. 点击**View Portal**,从**Available Portals**选择你的portal。插件会帮你填好**Portal Key**。 4. 把你的key粘贴到**API Secret Key**。 5. 在**Payment Channels**,取消勾选你不要的渠道。一开始所有渠道都已勾选。 6. 要收取真实付款,请保持**Enable Sandbox Mode**不勾选。 7. 保存。 ## 把Bayarcash加入表单 每个收款的表单都需要一个Bayarcash feed。表单也需要一个产品或总额栏位,以及顾客姓名和电邮的栏位。 1. 打开表单,前往**Settings** → **Bayarcash**,然后添加一个新的feed。 2. 为feed取一个名称。 3. 在**Configuration Type**,选择**Global Configuration**,使用设置页面里的key。如果只想让这个表单使用另一个账号或portal,请选择**Form Configuration**,然后填写出现的key、渠道和sandbox设置。 4. 选择交易类型和付款金额。 5. 在Client Information.下,把**Email**和**Full Name**对应到你的表单栏位。**Phone Number**是可选的。 6. 可选:把**Purhase Description**(插件里就是这样拼写的)对应到一个栏位,这个栏位的文字会随付款一起发送。 7. 可选:设置**Cancel URL**,也就是顾客取消付款时前往的页面。如果留空,顾客会回到表单。 8. 保存feed。 表单加载后,顾客会看到**Select Payment Method**,里面列出你勾选的渠道。你可以在**Payment Completed**和**Payment Failed**通知事件发送电邮。 ## 在sandbox测试 勾选**Enable Sandbox Mode**时,付款会进入Bayarcash sandbox,并使用插件内置的测试key。付款不会使用你输入的key。 1. 勾选**Enable Sandbox Mode**,然后保存。 2. 提交你的表单,在sandbox页面付款。 3. 测试成功后,取消勾选**Enable Sandbox Mode**,保存,然后进行一笔小额的真实付款,检查你自己的key。 设为**Form Configuration**的feed有自己的**Enable Sandbox Mode**勾选框,也请检查它。 ## 付款结果怎样传到你的网站 你不需要把callback URL粘贴到商家后台(merchant dashboard)。插件会在每笔付款中附上它自己的地址,也就是你网站上的`/?callback=bayarcash-for-gravity-forms`,Bayarcash会把结果发送到那里。插件会把表单记录(entry)标为已付款、pending或失败,并在记录里添加一则备注。 如果付款成功后表单记录仍然是pending,请确认你的网站是公开的、使用HTTPS,而且没有防火墙或安全插件拦截那个地址。请参阅[Callback和checksum](/zh/callbacks-and-checksum/)。 ## 小贴士 两个好习惯,让你更顺利使用Gravity Forms: - **一定要用正式key测试一次**。Sandbox模式使用插件自己的key,所以不能证明你的key是正确的。 - **不同的促销活动使用Form Configuration**。每个表单使用不同的portal,可以在Bayarcash报告里把每个促销活动的付款分开。 ## 常见问题 ### 我的表单显示“Required fields (email and name) must be mapped in the feed settings.” 打开表单的Bayarcash feed,在Client Information.下,把Email和Full Name对应到你表单上的栏位。两者都是必填。 ### 我的表单显示“Global Bayarcash settings are not properly configured.” 这个feed使用Global Configuration,但全局设置页面缺少一个key。前往Forms → Settings → Bayarcash,填写Personal Access Token (PAT)、Portal Key和API Secret Key。如果信息显示的是“Form-specific”,请在feed里填写key。 ### 顾客看到“Payment gateway error. Please try again later.”,发生了什么事? Bayarcash拒绝了这个付款request,表单记录也没有保存。请检查你的key,并确认你勾选的渠道已在你的portal开启。请参阅为什么我的付款失败? (/zh/payment-failed/)。 ### WordPress说缺少必需的dependencies,并要我运行composer install。我该怎么办? 插件文件不完整。请删除插件,然后用Bayarcash提供的完整版本重新安装。 --- # Connect Paymattic to Bayarcash > Install Bayarcash for Paymattic, enter your keys and add Bayarcash payment methods to your Paymattic Pro forms. > > Source: https://docs.bayarcash.com/paymattic/ **Bayarcash for Paymattic** adds Bayarcash payment methods to your Paymattic Pro forms. Your customer fills in the form, pays on the Bayarcash page and comes back to your form's confirmation. To see the plugin at work before you install it, try the [live demo](https://form.bayarcash-demo.com/paymattic/). ## What it supports Each channel is a payment method you add to a form: | Payment method | What your customer pays with | |---|---| | FPX Online Banking | FPX online banking | | Credit Card | A credit card account through FPX | | DuitNow Online Banking | DuitNow Online Banking/Wallets | | DuitNow QR | Any DuitNow QR banking or e-wallet app | | SPayLater | SPayLater by Shopee | | Boost PayFlex | Boost PayFlex | | Indonesia Online Banking | Indonesian online banking (QRIS) | | Indonesia e-Wallet | Indonesian e-wallets (QRIS) | | NETS Singapore | NETS (Singapore) | Payments are one-off and in MYR only. Subscriptions and Direct Debit are not supported. A channel only works if it is also turned on for your Bayarcash portal. See [Payment channels](/payment-channels/). ## Before you start You need these before you set up the plugin: - An approved Bayarcash merchant account. - Your **Personal Access Token (PAT)**, **API Secret Key** and **Portal Key**. See [Find your API keys](/api-keys/). - Paymattic Pro installed and active, with the currency set to Malaysian ringgit (MYR). - The Bayarcash for Paymattic plugin zip file. It is not on WordPress.org: [download the zip file](https://bayarcash.com/wp-content/uploads/sites/2/2025/02/bayarcash-for-paymattic.zip) from Bayarcash. ## Install the plugin Upload the zip file to WordPress: 1. In WordPress, go to **Plugins** → **Add New** → **Upload Plugin**. 2. Choose the zip file and click **Install Now**. 3. Click **Activate Plugin**. ## Enter your keys Enter your keys once for all your forms: 1. Go to **Paymattic** → **Bayarcash Settings**. The **Global Configuration** tab opens. 2. Leave **Enable Sandbox Mode** off for real payments. 3. Paste your token into **Personal Access Token** and click **Verify Token**. It shows "Token verified successfully" when the token works. 4. Paste your portal key into **Portal Key**. 5. Paste your key into **API Secret Key**. 6. Optional: under **Miscellaneous**, change **Payment Title**. It is **Bayarcash** by default. 7. Save your settings. ## Add Bayarcash to a form Once your keys are saved, add the payment methods to each form: 1. Open the form in Paymattic. 2. Add a name field and an email field if the form does not have them. Bayarcash needs both. 3. Add the Bayarcash payment method elements you want, for example **FPX Online Banking** and **DuitNow QR**. Each can be added once per form. 4. Optional: change each method's **Payment Option Label**. It is "Pay with" and the method name by default. 5. Save the form. ## Use different keys on one form A form can use its own Bayarcash account or portal instead of the global one: 1. In **Paymattic** → **Bayarcash Settings**, open **Form Configuration** and pick the form. 2. Turn on **Customization**. 3. Enter the **Personal Access Token**, **Portal Key** and **API Secret Key** for this form. 4. Save your settings. ## Add a processing fee The **Bayarcash Gateway Fee** tab lets you add a fee to the amount your customer pays. You can set it for **FPX Online Banking**, **Credit Card**, **DuitNow Online Banking** and **DuitNow QR**, as a flat amount, a percentage or both, with a description your customer sees. Other channels use the **DuitNow QR** fee. ## Test in sandbox Test on the Bayarcash sandbox before you take real payments: 1. Get a token, secret key and portal key from the [sandbox merchant dashboard](https://console.bayarcash-sandbox.com). Live keys do not work in the sandbox. 2. Turn on **Enable Sandbox Mode**. The page shows "Sandbox mode is enabled. Make sure to use sandbox credentials for testing." 3. Enter the sandbox keys, verify the token and save. 4. Submit a test payment on your form. 5. When it works, turn off **Enable Sandbox Mode**, enter your live keys and save again. A form with **Customization** on has its own **Enable Sandbox Mode** switch. Check it too. ## How payment results reach your site You do not paste a callback URL into the merchant dashboard. The plugin sends its own addresses with each payment: Bayarcash reports the result to your site at `/index.php?wpf_payment_api_notify=1`, and your customer returns to your form's confirmation page. The plugin marks the payment paid or failed. A payment that is still pending stays pending. Always confirm a payment in the merchant dashboard before you deliver anything of high value. See [Transactions](/transactions/). If payments stay pending after a successful payment, make sure your site is public, uses HTTPS, and that no firewall or security plugin blocks that address. ## Tips Two habits help with Paymattic: - **Use Backup and Restore before big changes.** The **Backup and Restore** tab exports your Bayarcash settings so you can put them back later. - **Use a separate portal for each form that needs its own report.** A per-form portal keeps those payments apart in your Bayarcash reports. ## Common issues ### My form shows "Currency not supported. Only MYR is supported." How do I fix it? Bayarcash takes payments in MYR only. Set the currency to Malaysian ringgit in Paymattic's payment settings. Until you do, the Bayarcash settings page shows a red notice about non compatible currencies. ### My form shows "Bayarcash doesn't support subscriptions at this time". Bayarcash for Paymattic takes one-off payments only. Remove the subscription item from the form, or use a different payment method for it. ### Verify Token says "Verification failed" or "Invalid token or API response". The token is wrong, or it comes from the other environment. With Enable Sandbox Mode on, use a token from the sandbox merchant dashboard. With it off, use a token from the live merchant dashboard. See Find your API keys (/api-keys/). ### I see "Bayarcash for Paymattic requires Paymattic to be installed and activated." Install and activate Paymattic Pro first, then reload the page. --- # Sambungkan Paymattic kepada Bayarcash > Install Bayarcash for Paymattic, masukkan keys anda dan tambah kaedah bayaran Bayarcash pada form Paymattic Pro anda. > > Source: https://docs.bayarcash.com/ms/paymattic/ **Bayarcash for Paymattic** menambah kaedah bayaran Bayarcash pada form Paymattic Pro anda. Pelanggan anda mengisi form, membuat bayaran di page Bayarcash, dan kemudian kembali ke page pengesahan form anda. Untuk melihat plugin ini berfungsi sebelum anda install, cuba [demo langsung](https://form.bayarcash-demo.com/paymattic/). ## Kaedah bayaran yang disokong Setiap saluran ialah satu kaedah bayaran yang anda tambah pada form: | Kaedah bayaran | Pelanggan anda membayar dengan | |---|---| | FPX Online Banking | Online banking FPX | | Credit Card | Akaun kad kredit melalui FPX | | DuitNow Online Banking | DuitNow Online Banking/Wallets | | DuitNow QR | Mana-mana aplikasi perbankan atau e-wallet yang menyokong DuitNow QR | | SPayLater | SPayLater daripada Shopee | | Boost PayFlex | Boost PayFlex | | Indonesia Online Banking | Online banking Indonesia (QRIS) | | Indonesia e-Wallet | E-wallet Indonesia (QRIS) | | NETS Singapore | NETS (Singapura) | Setiap bayaran ialah bayaran sekali sahaja, dalam MYR. Langganan dan Direct Debit tidak disokong. Sesuatu saluran hanya berfungsi jika saluran itu juga di-on-kan untuk portal Bayarcash anda. Lihat [Saluran bayaran](/ms/payment-channels/). ## Sebelum anda mula Sediakan perkara ini sebelum anda menyediakan plugin: - Akaun merchant Bayarcash yang sudah diluluskan. - **Personal Access Token (PAT)**, **API Secret Key** dan **Portal Key** anda. Lihat [Cari API keys anda](/ms/api-keys/). - Paymattic Pro yang sudah di-install dan aktif, dengan mata wang ringgit Malaysia (MYR). - Fail zip plugin Bayarcash for Paymattic. Plugin ini tiada di WordPress.org. [Muat turun fail zip](https://bayarcash.com/wp-content/uploads/sites/2/2025/02/bayarcash-for-paymattic.zip) daripada Bayarcash. ## Install plugin Upload fail zip itu ke WordPress: 1. Dalam WordPress, pergi ke **Plugins** → **Add New** → **Upload Plugin**. 2. Pilih fail zip itu dan klik **Install Now**. 3. Klik **Activate Plugin**. ## Masukkan keys anda Anda hanya perlu masukkan keys sekali untuk semua form anda: 1. Pergi ke **Paymattic** → **Bayarcash Settings**. Tab **Global Configuration** dibuka. 2. Biarkan **Enable Sandbox Mode** off untuk bayaran sebenar. 3. Paste token anda ke dalam **Personal Access Token** dan klik **Verify Token**. Jika token itu sah, mesej "Token verified successfully" dipaparkan. 4. Paste portal key anda ke dalam **Portal Key**. 5. Paste secret key anda ke dalam **API Secret Key**. 6. Pilihan: di bawah **Miscellaneous**, tukar **Payment Title**. Secara default, tajuk ini ialah **Bayarcash**. 7. Simpan tetapan anda. ## Tambah Bayarcash pada form Selepas keys anda disimpan, tambah kaedah bayaran pada setiap form: 1. Buka form itu dalam Paymattic. 2. Tambah ruangan nama dan ruangan e-mel jika form itu belum ada ruangan ini. Bayarcash memerlukan kedua-duanya. 3. Tambah elemen kaedah bayaran Bayarcash yang anda mahu, contohnya **FPX Online Banking** dan **DuitNow QR**. Setiap elemen hanya boleh ditambah sekali dalam satu form. 4. Pilihan: tukar **Payment Option Label** bagi setiap kaedah. Secara default, label ini ialah "Pay with" diikuti nama kaedah itu. 5. Simpan form itu. ## Guna keys lain untuk satu form Sesuatu form boleh menggunakan akaun atau portal Bayarcash sendiri, dan bukan tetapan global: 1. Dalam **Paymattic** → **Bayarcash Settings**, buka **Form Configuration** dan pilih form itu. 2. On-kan **Customization**. 3. Masukkan **Personal Access Token**, **Portal Key** dan **API Secret Key** untuk form ini. 4. Simpan tetapan anda. ## Tambah caj pemprosesan Dengan tab **Bayarcash Gateway Fee**, anda boleh menambah caj pada amaun yang pelanggan bayar. Caj ini boleh ditetapkan untuk **FPX Online Banking**, **Credit Card**, **DuitNow Online Banking** dan **DuitNow QR**. Caj boleh dalam amaun tetap, peratusan, atau kedua-duanya, dengan keterangan yang pelanggan nampak. Saluran lain menggunakan caj **DuitNow QR**. ## Uji dalam sandbox Buat ujian dalam sandbox Bayarcash sebelum anda menerima bayaran sebenar: 1. Dapatkan token, secret key dan portal key dari [merchant dashboard sandbox](https://console.bayarcash-sandbox.com). Keys live tidak berfungsi dalam sandbox. 2. On-kan **Enable Sandbox Mode**. Page itu memaparkan "Sandbox mode is enabled. Make sure to use sandbox credentials for testing." 3. Masukkan keys sandbox, sahkan token dan simpan. 4. Buat satu test payment pada form anda. 5. Apabila semuanya berfungsi, off-kan **Enable Sandbox Mode**, masukkan keys live anda dan simpan semula. Jika **Customization** di-on-kan untuk sesuatu form, form itu ada suis **Enable Sandbox Mode** sendiri. Semak suis itu juga. ## Cara Bayarcash menghantar keputusan bayaran ke laman web anda Anda tidak perlu paste callback URL ke dalam merchant dashboard. Plugin ini menghantar alamatnya sendiri bersama setiap bayaran. Bayarcash melaporkan keputusan bayaran ke laman web anda di `/index.php?wpf_payment_api_notify=1`, dan pelanggan anda kembali ke page pengesahan form anda. Plugin ini menandakan bayaran itu sebagai sudah dibayar atau gagal. Bayaran yang masih pending kekal pending. Sentiasa sahkan bayaran dalam merchant dashboard sebelum anda menghantar apa-apa yang bernilai tinggi. Lihat [Transaksi](/ms/transactions/). Jika bayaran kekal pending walaupun pelanggan berjaya membayar, pastikan laman web anda boleh diakses oleh umum dan menggunakan HTTPS. Pastikan juga tiada firewall atau plugin keselamatan yang menyekat alamat itu. ## Tips Dua habit ini membantu anda dengan Paymattic: - **Guna Backup and Restore sebelum perubahan besar.** Dengan tab **Backup and Restore**, anda boleh export tetapan Bayarcash anda dan memulihkannya kemudian. - **Guna portal berasingan untuk setiap form yang memerlukan laporan sendiri.** Jika satu form ada portal sendiri, bayaran form itu berasingan dalam laporan Bayarcash anda. ## Isu biasa ### Kenapa form saya memaparkan "Currency not supported. Only MYR is supported."? Bayarcash hanya menerima bayaran dalam MYR. Tukar mata wang kepada ringgit Malaysia dalam tetapan bayaran Paymattic. Selagi mata wang belum ditukar, page tetapan Bayarcash memaparkan notis merah tentang mata wang yang tidak disokong. ### Kenapa form saya memaparkan "Bayarcash doesn't support subscriptions at this time"? Bayarcash for Paymattic hanya untuk bayaran sekali sahaja. Buang item langganan daripada form itu, atau guna kaedah bayaran lain untuk item itu. ### Kenapa Verify Token memaparkan "Verification failed" atau "Invalid token or API response"? Token itu salah, atau token itu dari merchant dashboard yang lain. Jika Enable Sandbox Mode di-on-kan, guna token dari merchant dashboard sandbox. Jika suis itu off, guna token dari merchant dashboard live. Lihat Cari API keys anda (/ms/api-keys/). ### Kenapa saya nampak "Bayarcash for Paymattic requires Paymattic to be installed and activated."? Install dan aktifkan Paymattic Pro dahulu, kemudian refresh page itu. --- # 把Paymattic连接到Bayarcash > 安装Bayarcash for Paymattic,输入你的key,并把Bayarcash付款方式加入你的Paymattic Pro表单。 > > Source: https://docs.bayarcash.com/zh/paymattic/ **Bayarcash for Paymattic**把Bayarcash付款方式加入你的Paymattic Pro表单。你的顾客填写表单,在Bayarcash页面付款,然后回到你表单的确认页面。 安装之前想先看看插件怎样运作,可以试试[在线演示](https://form.bayarcash-demo.com/paymattic/)。 ## 支持的付款方式 每个渠道都是一种你可以加入表单的付款方式: | 付款方式 | 你的顾客用什么付款 | |---|---| | FPX Online Banking | FPX网上银行 | | Credit Card | 通过FPX使用信用卡账户 | | DuitNow Online Banking | DuitNow Online Banking/Wallets | | DuitNow QR | 任何支持DuitNow QR的银行或电子钱包App | | SPayLater | Shopee的SPayLater | | Boost PayFlex | Boost PayFlex | | Indonesia Online Banking | 印尼网上银行(QRIS) | | Indonesia e-Wallet | 印尼电子钱包(QRIS) | | NETS Singapore | NETS(新加坡) | 付款只限一次性付款,而且只接受MYR。不支持订阅和Direct Debit。一个渠道必须同时在你的Bayarcash portal开启,才能使用。请参阅[付款渠道](/zh/payment-channels/)。 ## 开始之前 设置插件之前,你需要准备好这些: - 一个已获批准的Bayarcash商家账号。 - 你的**Personal Access Token (PAT)**、**API Secret Key**和**Portal Key**。请参阅[找到你的API key](/zh/api-keys/)。 - 已安装并启用的Paymattic Pro,货币设为马来西亚令吉(MYR)。 - Bayarcash for Paymattic插件的zip文件。它不在WordPress.org上:请从Bayarcash[下载zip文件](https://bayarcash.com/wp-content/uploads/sites/2/2025/02/bayarcash-for-paymattic.zip)。 ## 安装插件 把zip文件上传到WordPress: 1. 在WordPress里,前往**Plugins** → **Add New** → **Upload Plugin**。 2. 选择zip文件,然后点击**Install Now**。 3. 点击**Activate Plugin**。 ## 输入你的key 为所有表单输入一次key就可以: 1. 前往**Paymattic** → **Bayarcash Settings**。页面会打开**Global Configuration**标签页。 2. 要收取真实付款,请让**Enable Sandbox Mode**保持关闭。 3. 把你的token粘贴到**Personal Access Token**,然后点击**Verify Token**。token有效时,会显示“Token verified successfully”。 4. 把你的portal key粘贴到**Portal Key**。 5. 把你的key粘贴到**API Secret Key**。 6. 可选:在**Miscellaneous**下,更改**Payment Title**。默认是**Bayarcash**。 7. 保存你的设置。 ## 把Bayarcash加入表单 保存key之后,把付款方式加入每个表单: 1. 在Paymattic打开表单。 2. 如果表单还没有姓名栏位和电邮栏位,请添加它们。Bayarcash两者都需要。 3. 添加你想要的Bayarcash付款方式元素,例如**FPX Online Banking**和**DuitNow QR**。每个表单的每种付款方式只能添加一次。 4. 可选:更改每种付款方式的**Payment Option Label**。默认是“Pay with”加上付款方式名称。 5. 保存表单。 ## 在一个表单使用不同的key 一个表单可以使用自己的Bayarcash账号或portal,而不是全局设置: 1. 在**Paymattic** → **Bayarcash Settings**,打开**Form Configuration**,然后选择表单。 2. 开启**Customization**。 3. 为这个表单输入**Personal Access Token**、**Portal Key**和**API Secret Key**。 4. 保存你的设置。 ## 添加手续费 在**Bayarcash Gateway Fee**标签页,你可以在顾客支付的金额上加一笔手续费。你可以为**FPX Online Banking**、**Credit Card**、**DuitNow Online Banking**和**DuitNow QR**设置手续费,方式可以是固定金额、百分比或两者都用,并加上一段顾客会看到的说明。其他渠道使用**DuitNow QR**的手续费。 ## 在sandbox测试 收取真实付款之前,先在Bayarcash sandbox测试: 1. 从[sandbox商家后台(merchant dashboard)](https://console.bayarcash-sandbox.com)获取token、secret key和portal key。正式key不能在sandbox使用。 2. 开启**Enable Sandbox Mode**。页面会显示“Sandbox mode is enabled. Make sure to use sandbox credentials for testing.” 3. 输入sandbox key,验证token,然后保存。 4. 在你的表单提交一笔测试付款。 5. 测试成功后,关闭**Enable Sandbox Mode**,输入你的正式key,然后再保存一次。 开启了**Customization**的表单有自己的**Enable Sandbox Mode**开关,也请检查它。 ## 付款结果怎样传到你的网站 你不需要把callback URL粘贴到商家后台。插件会在每笔付款中附上它自己的地址:Bayarcash会把结果报告到你网站上的`/index.php?wpf_payment_api_notify=1`,而顾客会回到你表单的确认页面。插件会把付款标为已付款或失败。仍是pending的付款会保持pending。 交付任何高价值的东西之前,一定要先在商家后台确认付款。请参阅[交易](/zh/transactions/)。 如果付款成功后付款记录仍然是pending,请确认你的网站是公开的、使用HTTPS,而且没有防火墙或安全插件拦截那个地址。 ## 小贴士 两个好习惯,让你更顺利使用Paymattic: - **做大改动之前,先用Backup and Restore**。你可以在**Backup and Restore**标签页导出你的Bayarcash设置,方便之后恢复。 - **需要独立报告的表单,各自使用不同的portal**。每个表单使用自己的portal,可以在Bayarcash报告里把这些付款分开。 ## 常见问题 ### 我的表单显示“Currency not supported. Only MYR is supported.”,怎样解决? Bayarcash只接受MYR付款。在Paymattic的付款设置里,把货币设为马来西亚令吉。改好之前,Bayarcash设置页面会显示一则红色通知,说明货币不兼容。 ### 我的表单显示“Bayarcash doesn't support subscriptions at this time”。 Bayarcash for Paymattic只接受一次性付款。请从表单移除订阅项目,或为它使用另一种付款方式。 ### Verify Token显示“Verification failed”或“Invalid token or API response”。 token不正确,或者它来自另一个环境。Enable Sandbox Mode开启时,请用sandbox商家后台的token。关闭时,请用正式环境商家后台的token。请参阅找到你的API key (/zh/api-keys/)。 ### 我看到“Bayarcash for Paymattic requires Paymattic to be installed and activated.” 请先安装并启用Paymattic Pro,然后重新加载页面。 --- # Send MyInvois e-invoices from WooCommerce > Use the e-Invoice for MyInvois LHDN plugin so customers can request an e-invoice for paid Bayarcash orders in your WooCommerce shop. > > Source: https://docs.bayarcash.com/myinvois-e-invoice/ The e-Invoice for MyInvois LHDN plugin lets your WooCommerce customers request an official e-invoice for an order they paid through Bayarcash. It sends the e-invoice to LHDN MyInvois through Submit eInvoice. Use it if your business must issue e-invoices. ## Before you start You need the following: - A WooCommerce shop that already takes payments with the [Bayarcash WooCommerce plugin](/woocommerce/). The e-invoice plugin only works with Bayarcash payment methods. - A Submit eInvoice account. Its **API Secret Key** is different from your Bayarcash keys. You do not need a Bayarcash token or portal key for this plugin. - Your company details, including your Tax Identification Number (TIN) and MSIC code. ## Install the plugin The plugin is on WordPress.org as e-invoice-for-myinvois-lhdn. To install it: 1. In WordPress, go to **Plugins** and search for "e-Invoice for MyInvois LHDN", or upload the plugin zip. 2. Click **Activate**. 3. Make sure WooCommerce and the Bayarcash WooCommerce plugin are also active. ## Connect and set up your company The setup is one page. Work down it from the top. 1. Go to **MyInvois** → **Settings**. 2. Under **API Configuration**, paste your key into **API Secret Key**. Use **Go to Profile** if you need to find it in your Submit eInvoice profile. 3. Click **Save API Key**, then **Test Connection**. A green **Ready for E-Invoice Submission** box means the connection works. 4. Fill in **Company Information**: company name, email, mobile number, identification scheme and number, **TIN**, **MSIC Code**, **Business Activity Description** and **Default Product Classification Code**. **SST Registration Number** and **Tourism Tax Registration Number** are only for businesses that have them. 5. Fill in **Company Address**. 6. Click **Save Settings**. If a required field is empty, the page shows **Missing Required Information** and lists what is missing. > **Tip** > Beside **TIN**, the search button finds your TIN from your identification details. Fill in the API Secret Key and identification fields first. ## Set product classification codes Each product needs a classification code for MyInvois. To set it: 1. Open a product in WooCommerce and go to its **E-Invoice** section. 2. Leave **Use Global Classification Code** on to use your default code, or turn it off and choose a **MyTax Classification Code** for this product. ## How your customer requests an e-invoice After a paid order, the customer's order details page shows **E-Invoice Available** with a **Request E-Invoice** button. They fill in their buyer details and identification, then submit. You can follow each one under **MyInvois** → **Invoices**, or in the **E-Invoice Details** box on the order, where **Check Status** refreshes the result. ## Tips - **Tell customers about the 90-hour limit.** MyTax rules give them 90 hours from the order date to request an e-invoice. - **Turn on Enable Logging only while fixing a problem.** It records API requests, which helps support find the cause. ## Common issues ### The MyInvois settings page shows Plugin Dependencies Required. What do I do? Install and activate both WooCommerce and the Bayarcash WooCommerce plugin, then open MyInvois → Settings again. The plugin does not work without them. ### My customer says the e-invoice link has expired. A customer can request an e-invoice only within 90 hours (3.75 days) of the order date. After that the order page shows E-Invoice Request Expired. ### The Test Connection button fails. What should I check? Check that you pasted the API Secret Key from your Submit eInvoice profile, not a Bayarcash key, and that all the required company fields are filled in. --- # Hantar e-invois melalui MyInvois dari WooCommerce > Guna plugin e-Invoice for MyInvois LHDN supaya pelanggan kedai WooCommerce anda boleh minta e-invois untuk pesanan Bayarcash yang sudah dibayar. > > Source: https://docs.bayarcash.com/ms/myinvois-e-invoice/ Dengan plugin e-Invoice for MyInvois LHDN, pelanggan WooCommerce anda boleh minta e-invois rasmi untuk pesanan yang mereka bayar melalui Bayarcash. Plugin ini menghantar e-invois ke MyInvois LHDN melalui Submit eInvoice. Guna plugin ini jika perniagaan anda wajib mengeluarkan e-invois. ## Sebelum anda mula Anda memerlukan perkara berikut: - Kedai WooCommerce yang sudah menerima bayaran dengan [plugin Bayarcash WooCommerce](/ms/woocommerce/). Plugin e-invois ini hanya berfungsi dengan kaedah bayaran Bayarcash. - Akaun Submit eInvoice. **API Secret Key** akaun ini berbeza daripada keys Bayarcash anda. Anda tidak memerlukan token atau portal key Bayarcash untuk plugin ini. - Butiran syarikat anda, termasuk Tax Identification Number (TIN) dan kod MSIC. ## Install plugin Plugin ini ada di WordPress.org sebagai e-invoice-for-myinvois-lhdn. Untuk install plugin ini: 1. Dalam WordPress, pergi ke **Plugins** dan cari "e-Invoice for MyInvois LHDN", atau upload fail zip plugin itu. 2. Klik **Activate**. 3. Pastikan WooCommerce dan plugin Bayarcash WooCommerce juga aktif. ## Sambungkan & isi butiran syarikat Semua tetapan ada pada satu page. Isi page itu dari atas ke bawah. 1. Pergi ke **MyInvois** → **Settings**. 2. Di bawah **API Configuration**, paste key anda ke dalam **API Secret Key**. Klik **Go to Profile** jika anda perlu mencari key itu dalam profil Submit eInvoice anda. 3. Klik **Save API Key**, kemudian **Test Connection**. Kotak hijau **Ready for E-Invoice Submission** bermaksud sambungan berjaya. 4. Isi **Company Information**: nama syarikat, e-mel, nombor telefon bimbit, jenis ID dan nombor ID, **TIN**, **MSIC Code**, **Business Activity Description** dan **Default Product Classification Code**. **SST Registration Number** dan **Tourism Tax Registration Number** hanya untuk perniagaan yang ada nombor itu. 5. Isi **Company Address**. 6. Klik **Save Settings**. Jika ada ruangan wajib yang masih kosong, page itu memaparkan **Missing Required Information** dan senarai butiran yang tiada. > **Tip** > Butang carian di sebelah **TIN** mendapatkan TIN anda berdasarkan jenis ID dan nombor ID anda. Isi API Secret Key dan ruangan ID dahulu. ## Tetapkan kod klasifikasi produk Setiap produk memerlukan kod klasifikasi untuk MyInvois. Untuk menetapkannya: 1. Buka produk itu dalam WooCommerce dan pergi ke bahagian **E-Invoice** produk itu. 2. Biarkan **Use Global Classification Code** on untuk menggunakan kod default anda. Atau, off-kan suis itu dan pilih **MyTax Classification Code** untuk produk ini. ## Cara pelanggan anda minta e-invois Selepas pesanan dibayar, page butiran pesanan pelanggan memaparkan **E-Invoice Available** dengan butang **Request E-Invoice**. Pelanggan mengisi butiran pembeli dan ID mereka, kemudian menghantar permintaan itu. Anda boleh semak setiap permintaan di **MyInvois** → **Invoices**, atau dalam kotak **E-Invoice Details** pada pesanan itu. Di kotak itu, **Check Status** mengemas kini status e-invois. ## Tips Dua habit ini membantu anda dengan plugin MyInvois: - **Beritahu pelanggan tentang had 90 jam.** Peraturan MyTax memberi pelanggan 90 jam dari tarikh pesanan untuk minta e-invois. - **On-kan Enable Logging hanya semasa anda menyelesaikan masalah.** Tetapan ini merekod API request, dan rekod ini membantu team Bayarcash mencari punca masalah. ## Isu biasa ### Kenapa page tetapan MyInvois memaparkan Plugin Dependencies Required? Install dan aktifkan WooCommerce dan plugin Bayarcash WooCommerce, kemudian buka MyInvois → Settings sekali lagi. Plugin ini tidak berfungsi tanpa kedua-dua plugin itu. ### Kenapa pelanggan saya kata link e-invois sudah tamat tempoh? Pelanggan hanya boleh minta e-invois dalam tempoh 90 jam (3.75 hari) dari tarikh pesanan. Selepas itu, page pesanan memaparkan E-Invoice Request Expired. ### Kenapa butang Test Connection gagal? Pastikan anda paste API Secret Key dari profil Submit eInvoice anda, bukan key Bayarcash. Pastikan juga semua ruangan syarikat yang wajib sudah diisi. --- # 从WooCommerce发送MyInvois电子发票 > 使用e-Invoice for MyInvois LHDN插件,让顾客为WooCommerce店里已用Bayarcash付款的订单申请电子发票。 > > Source: https://docs.bayarcash.com/zh/myinvois-e-invoice/ e-Invoice for MyInvois LHDN插件让你的WooCommerce顾客为通过Bayarcash付款的订单申请正式的电子发票(e-Invoice)。它通过Submit eInvoice把电子发票发送到LHDN MyInvois。如果你的生意必须开电子发票,就使用这个插件。 ## 开始之前 你需要以下这些: - 一间已经用[Bayarcash WooCommerce插件](/zh/woocommerce/)收款的WooCommerce网店。这个电子发票插件只适用于Bayarcash的付款方式。 - 一个Submit eInvoice账号。它的**API Secret Key**和你的Bayarcash key不同。这个插件不需要Bayarcash token或portal key。 - 你的公司资料,包括你的税务识别号码(TIN)和MSIC代码。 ## 安装插件 这个插件在WordPress.org上的名称是e-invoice-for-myinvois-lhdn。安装步骤: 1. 在WordPress前往**Plugins**,搜索“e-Invoice for MyInvois LHDN”,或上传插件的zip文件。 2. 点击**Activate**。 3. 确认WooCommerce和Bayarcash WooCommerce插件也已启用。 ## 连接并设置你的公司资料 所有设置都在同一个页面。从上到下逐项完成。 1. 前往**MyInvois** → **Settings**。 2. 在**API Configuration**下,把你的key粘贴到**API Secret Key**。如果你需要在Submit eInvoice个人资料里找key,点击**Go to Profile**。 3. 点击**Save API Key**,然后点击**Test Connection**。绿色的**Ready for E-Invoice Submission**方框表示连接成功。 4. 填写**Company Information**:公司名称、电邮、手机号码、身份识别类型和号码、**TIN**、**MSIC Code**、**Business Activity Description**和**Default Product Classification Code**。**SST Registration Number**和**Tourism Tax Registration Number**只适用于有这些号码的商家。 5. 填写**Company Address**。 6. 点击**Save Settings**。 如果有必填栏位是空的,页面会显示**Missing Required Information**,并列出缺少的资料。 > **Tip** > **TIN**旁边的搜索按钮会根据你的身份识别资料找出你的TIN。请先填写API Secret Key和身份识别栏位。 ## 设置产品分类代码 每个产品都需要MyInvois的分类代码。设置步骤: 1. 在WooCommerce打开一个产品,前往它的**E-Invoice**部分。 2. 保持**Use Global Classification Code**开启,以使用你的默认代码;或把它关闭,为这个产品选择**MyTax Classification Code**。 ## 你的顾客怎样申请电子发票 订单付款后,顾客的订单详情页面会显示**E-Invoice Available**和**Request E-Invoice**按钮。他们填写买家资料和身份识别资料,然后提交。你可以在**MyInvois** → **Invoices**跟进每一个申请,或在订单的**E-Invoice Details**方框查看,那里的**Check Status**会刷新结果。 ## 小贴士 - **告诉顾客90小时的期限**。MyTax规则让顾客从订单日期起有90小时申请电子发票。 - **只在排查问题时开启Enable Logging**。它会记录API request,帮助支持团队找出原因。 ## 常见问题 ### MyInvois设置页面显示Plugin Dependencies Required。我该怎么做? 安装并启用WooCommerce和Bayarcash WooCommerce插件,然后再打开MyInvois → Settings。没有这两个插件,这个插件无法运作。 ### 我的顾客说电子发票链接已过期。 顾客只能在订单日期起90小时(3.75天)内申请电子发票。之后,订单页面会显示E-Invoice Request Expired。 ### Test Connection按钮失败了。我该检查什么? 检查你粘贴的是Submit eInvoice个人资料里的API Secret Key,而不是Bayarcash的key,并确认所有必填的公司栏位都已填写。 --- # Accept Bayarcash payments in WHMCS > Install the Bayarcash gateway module in WHMCS, add your keys, set up the cron job and optionally add gateway fees to invoices. > > Source: https://docs.bayarcash.com/whmcs/ The Bayarcash module for WHMCS lets your clients pay invoices through Bayarcash. It takes MYR invoices only. This guide covers the gateway, the cron job and the optional fees add-on. ## Before you start You need the following: - An approved Bayarcash merchant account with the payment channels you want switched on. - Your **Personal Access Token (PAT)**, **Portal Key** and **API Secret Key**. See [API keys](/api-keys/) and [Portals](/portals/). - Admin access to WHMCS and to the server files or cron settings. ## Install the module Download the module from the [WHMCS Marketplace](https://marketplace.whmcs.com/product/7531-bayarcash). Then: 1. Unzip the file. Check that it has a **modules** folder with **addons** and **gateways** inside. 2. Upload the **modules** folder to your WHMCS installation folder, so the files merge with the existing ones. 3. In the WHMCS admin area, go to **System Settings** → **Payment Gateways**. 4. Open the **All Payment Gateways** tab, find **Bayarcash** and activate it. ## Add your keys and choose channels On the Bayarcash settings, fill in these fields: | Field | What to enter | |---|---| | **Personal Access Token (PAT)** | Your Bayarcash token. | | **Portal Key** | The portal that should receive the payments. | | **API Secret Key** | Your secret key. Keep it private. | | **Sandbox Mode** | Turn on only for testing, with sandbox keys. | | **Payment Information** | Text shown on the invoice page. | | **Successful Payment** and **Unsuccessful Payment** | The page the client lands on after paying or failing: **Specific Invoice**, **List Invoice** or **Client Area**. | | **Payment Channels** | The channel numbers to offer, separated by commas. | Click **Save Changes** when done. The channel numbers are: | Number | Channel | |---|---| | 1 | FPX Online Banking | | 4 | FPX Line of Credit (Credit Card Account) | | 5 | DuitNow Online Banking/Wallets | | 6 | DuitNow QR | | 7 | SPayLater | | 8 | Boost PayFlex | | 9 | QRIS Indonesia Online Banking | | 10 | QRIS Indonesia eWallet | | 11 | NETS Singapore | Your Bayarcash account must have a channel enabled before clients can use it. See [Payment channels](/payment-channels/). ## Set up the cron job Bayarcash needs a cron job that checks pending payments every minute. Ask your host to add this, replacing whmcsdomain with your WHMCS domain: ``` * * * * * wget -q -O /dev/null 'https://whmcsdomain/modules/gateways/bayarcash/bayarcash_cron.php?job=requery' ``` ## Add gateway fees to invoices (optional) Use the **Bayarcash Gateway Fees** add-on if you want to pass the payment fee to your client. It adds a fee line to the invoice for the channel the client picks. To set it up: 1. Go to **System Settings** → **Addon Modules**. 2. Find **Bayarcash Gateway Fees** and click **Activate**, then **Configure**. 3. Under **Access Control**, tick **Full Administrator** and save. 4. Open **Addons** → **Bayarcash Gateway Fees**. 5. For each channel, set **Flat Price (RM)** and **Percentage Fee (%)**, then click **Save All Settings**. Check the amounts against your own Bayarcash agreement before you save, because the add-on starts with sample values. ## Tips - **Test with Sandbox Mode first.** Use sandbox keys, pay one test invoice, then switch to live keys and turn it off. - **Keep the cron job running.** If it stops, clients may pay but their invoices stay unpaid until you check. ## Common issues ### My customer sees a message that Bayarcash only accepts payment in MYR. The invoice is in another currency. Bayarcash accepts MYR only, so issue the invoice in Malaysian Ringgit. ### Payments are made but invoices stay unpaid. Check that the requery cron job runs every minute, and that your Personal Access Token, Portal Key and API Secret Key are correct. The cron job updates pending payments. ### A customer sees 'An error occurred. Please try again later.' after choosing a channel. Check your credentials in the Bayarcash gateway settings. Turn on Sandbox Mode only when you use sandbox keys. --- # Terima bayaran Bayarcash dalam WHMCS > Install modul gateway Bayarcash dalam WHMCS, masukkan keys anda, sediakan cron job dan tambah caj gateway pada invois jika perlu. > > Source: https://docs.bayarcash.com/ms/whmcs/ Dengan modul Bayarcash untuk WHMCS, pelanggan anda boleh membayar invois melalui Bayarcash. Modul ini hanya menerima invois dalam MYR. Panduan ini menerangkan gateway, cron job dan add-on caj yang pilihan. ## Sebelum anda mula Anda memerlukan perkara berikut: - Akaun merchant Bayarcash yang sudah diluluskan, dengan saluran bayaran yang anda mahu sudah di-on-kan. - **Personal Access Token (PAT)**, **Portal Key** dan **API Secret Key** anda. Lihat [Cari API keys anda](/ms/api-keys/) dan [Portal](/ms/portals/). - Akses admin ke WHMCS, dan akses ke fail server atau tetapan cron. ## Install modul Muat turun modul dari [WHMCS Marketplace](https://marketplace.whmcs.com/product/7531-bayarcash). Kemudian: 1. Unzip fail itu. Pastikan fail itu ada folder **modules**, dengan folder **addons** dan **gateways** di dalamnya. 2. Upload folder **modules** ke folder WHMCS anda, supaya fail-fail itu bergabung dengan fail yang sedia ada. 3. Dalam admin area WHMCS, pergi ke **System Settings** → **Payment Gateways**. 4. Buka tab **All Payment Gateways**, cari **Bayarcash** dan aktifkan. ## Masukkan keys & pilih saluran Dalam tetapan Bayarcash, isi ruangan ini: | Ruangan | Apa yang perlu dimasukkan | |---|---| | **Personal Access Token (PAT)** | Token Bayarcash anda. | | **Portal Key** | Portal yang akan menerima bayaran. | | **API Secret Key** | Secret key anda. Jangan kongsi key ini. | | **Sandbox Mode** | On-kan hanya untuk ujian, dengan keys sandbox. | | **Payment Information** | Teks yang dipaparkan pada page invois. | | **Successful Payment** dan **Unsuccessful Payment** | Page yang pelanggan nampak selepas bayaran berjaya atau gagal: **Specific Invoice**, **List Invoice** atau **Client Area**. | | **Payment Channels** | Nombor saluran yang anda tawarkan, dipisahkan dengan koma. | Klik **Save Changes** apabila selesai. Nombor saluran ialah: | Nombor | Saluran | |---|---| | 1 | FPX Online Banking | | 4 | FPX Line of Credit (Credit Card Account) | | 5 | DuitNow Online Banking/Wallets | | 6 | DuitNow QR | | 7 | SPayLater | | 8 | Boost PayFlex | | 9 | QRIS Indonesia Online Banking | | 10 | QRIS Indonesia eWallet | | 11 | NETS Singapore | Sesuatu saluran mesti di-on-kan dalam akaun Bayarcash anda sebelum pelanggan boleh menggunakannya. Lihat [Saluran bayaran](/ms/payment-channels/). ## Sediakan cron job Bayarcash memerlukan cron job yang menyemak bayaran pending setiap minit. Minta host anda menambah cron job ini. Tukar whmcsdomain kepada domain WHMCS anda: ``` * * * * * wget -q -O /dev/null 'https://whmcsdomain/modules/gateways/bayarcash/bayarcash_cron.php?job=requery' ``` ## Tambah caj gateway pada invois (pilihan) Guna add-on **Bayarcash Gateway Fees** jika anda mahu pelanggan menanggung caj bayaran. Add-on ini menambah baris caj pada invois, mengikut saluran yang pelanggan pilih. Untuk menyediakannya: 1. Pergi ke **System Settings** → **Addon Modules**. 2. Cari **Bayarcash Gateway Fees** dan klik **Activate**, kemudian **Configure**. 3. Di bawah **Access Control**, tandakan **Full Administrator** dan simpan. 4. Buka **Addons** → **Bayarcash Gateway Fees**. 5. Untuk setiap saluran, tetapkan **Flat Price (RM)** dan **Percentage Fee (%)**, kemudian klik **Save All Settings**. Add-on ini bermula dengan nilai contoh. Jadi, semak amaun itu dengan perjanjian Bayarcash anda sebelum anda simpan. ## Tips Dua habit ini membantu anda dengan WHMCS: - **Uji dengan Sandbox Mode dahulu.** Guna keys sandbox dan bayar satu invois ujian. Kemudian, tukar kepada keys live dan off-kan Sandbox Mode. - **Pastikan cron job sentiasa berjalan.** Jika cron job berhenti, pelanggan mungkin sudah membayar, tetapi invois mereka kekal belum dibayar sehingga anda menyemaknya. ## Isu biasa ### Kenapa pelanggan saya nampak mesej bahawa Bayarcash hanya menerima bayaran dalam MYR? Invois itu dalam mata wang lain. Bayarcash hanya menerima MYR, jadi keluarkan invois dalam ringgit Malaysia. ### Kenapa invois masih belum dibayar walaupun pelanggan sudah membayar? Pastikan cron job requery berjalan setiap minit, dan Personal Access Token, Portal Key dan API Secret Key anda betul. Cron job itu yang mengemas kini bayaran yang masih pending. ### Kenapa pelanggan nampak 'An error occurred. Please try again later.' selepas memilih saluran? Semak keys anda dalam tetapan gateway Bayarcash. On-kan Sandbox Mode hanya apabila anda menggunakan keys sandbox. --- # 在WHMCS接受Bayarcash付款 > 在WHMCS安装Bayarcash支付网关模块,添加你的key,设置cron job,也可以把手续费加到发票上。 > > Source: https://docs.bayarcash.com/zh/whmcs/ WHMCS的Bayarcash模块让你的客户通过Bayarcash支付发票。它只接受MYR发票。这份指南介绍支付网关、cron job,以及可选的手续费add-on。 ## 开始之前 你需要准备好: - 已获批准的Bayarcash商家账号,并已开启你要用的付款渠道。 - 你的**Personal Access Token (PAT)**、**Portal Key**和**API Secret Key**。请参阅[找到你的API key](/zh/api-keys/)和[Portal](/zh/portals/)。 - WHMCS的管理员权限,以及服务器文件或cron设置的访问权限。 ## 安装模块 从[WHMCS Marketplace](https://marketplace.whmcs.com/product/7531-bayarcash)下载模块。然后: 1. 解压文件。确认里面有**modules**文件夹,文件夹里有**addons**和**gateways**。 2. 把**modules**文件夹上传到你的WHMCS安装文件夹,让文件和原有的文件合并。 3. 在WHMCS管理后台,前往**System Settings** → **Payment Gateways**。 4. 打开**All Payment Gateways**标签页,找到**Bayarcash**并启用它。 ## 添加key并选择渠道 在Bayarcash设置里,填写这些栏位: | 栏位 | 填写什么 | |---|---| | **Personal Access Token (PAT)** | 你的Bayarcash token。 | | **Portal Key** | 接收这些付款的portal。 | | **API Secret Key** | 你的secret key。不要告诉别人。 | | **Sandbox Mode** | 只在测试时开启,并使用sandbox key。 | | **Payment Information** | 显示在发票页面的文字。 | | **Successful Payment**和**Unsuccessful Payment** | 客户付款成功或失败后去到的页面:**Specific Invoice**、**List Invoice**或**Client Area**。 | | **Payment Channels** | 要提供的渠道号码,用逗号分开。 | 完成后点击**Save Changes**。渠道号码如下: | 号码 | 渠道 | |---|---| | 1 | FPX Online Banking | | 4 | FPX Line of Credit (Credit Card Account) | | 5 | DuitNow Online Banking/Wallets | | 6 | DuitNow QR | | 7 | SPayLater | | 8 | Boost PayFlex | | 9 | QRIS Indonesia Online Banking | | 10 | QRIS Indonesia eWallet | | 11 | NETS Singapore | 渠道必须先在你的Bayarcash账号开启,客户才能使用。请参阅[付款渠道](/zh/payment-channels/)。 ## 设置cron job Bayarcash需要一个每分钟检查待处理付款的cron job。请你的主机商添加以下cron job,并把whmcsdomain换成你的WHMCS域名: ``` * * * * * wget -q -O /dev/null 'https://whmcsdomain/modules/gateways/bayarcash/bayarcash_cron.php?job=requery' ``` ## 把手续费加到发票上(可选) 如果你想让客户承担付款手续费,可以使用**Bayarcash Gateway Fees** add-on。它会按客户选择的渠道,在发票上添加一行手续费。设置步骤: 1. 前往**System Settings** → **Addon Modules**。 2. 找到**Bayarcash Gateway Fees**,点击**Activate**,然后点击**Configure**。 3. 在**Access Control**下,勾选**Full Administrator**,然后保存。 4. 打开**Addons** → **Bayarcash Gateway Fees**。 5. 为每个渠道设置Flat Price (RM)和**Percentage Fee (%)**,然后点击**Save All Settings**。 这个add-on一开始用的是示例数值,所以保存之前,请对照你和Bayarcash的协议检查金额。 ## 小贴士 - **先用Sandbox Mode测试**。使用sandbox key,支付一张测试发票,然后换成正式key,并关闭Sandbox Mode。 - **让cron job一直运行**。如果它停了,客户可能已经付款,但他们的发票会一直显示未付款,直到你去检查。 ## 常见问题 ### 我的客户看到信息说Bayarcash只接受MYR付款,为什么? 这张发票用的是其他货币。Bayarcash只接受MYR,所以请用马币开发票。 ### 客户已经付款,但发票还是未付款,为什么? 检查requery cron job是否每分钟运行,以及你的Personal Access Token、Portal Key和API Secret Key是否正确。待处理的付款由这个cron job更新。 ### 客户选择渠道后看到“An error occurred. Please try again later.”,为什么? 检查Bayarcash支付网关设置里的key。只有在使用sandbox key时,才开启Sandbox Mode。 --- # Accept Bayarcash payments in HostBill > Install the Bayarcash payment module in HostBill and add your portal key, token and API secret key. > > Source: https://docs.bayarcash.com/hostbill/ The Bayarcash module for HostBill lets your clients pay invoices through Bayarcash. It accepts MYR only. ## Before you start You need the following: - An approved Bayarcash merchant account. - The Bayarcash module files for HostBill, from Bayarcash. - Your **Portal Key**, **Personal Access Token** and **API Secret Key**. See [API keys](/api-keys/) and [Portals](/portals/). - Access to your HostBill server files, with Composer available on the server. ## Install the module Your developer or host usually does this part. The steps are: 1. Copy the module folder into your HostBill installation, under the **includes/modules/Payment** folder. 2. In the module folder, run `composer install` to add the libraries it needs. 3. In the HostBill admin area, activate **Bayarcash** among the payment modules. ## Add your keys Open the Bayarcash module settings and fill in these fields: | Field | What to enter | |---|---| | **Portal Key** | The portal that should receive the payments. | | **Token** | Your Personal Access Token. | | **API Secret Key** | Your secret key. Keep it private. | | **Use sandbox** | Tick only when testing with sandbox keys. | Save the settings. On the payment page, your client chooses **FPX**, **FPX Line of Credit** or **DuitNow DOBW**. ## Tips - **Test in sandbox first.** Pay one test invoice with sandbox keys, then untick **Use sandbox** and switch to live keys. - **Check the module in your own HostBill version.** Bayarcash lists no minimum HostBill version, so test a payment before you go live. ## Common issues ### My customer sees 'Payment failed, please contact administrator'. Check the Portal Key, Token and API Secret Key in the module settings, and that your invoice is in MYR. Bayarcash accepts MYR only. ### The payment went through but I see 'Payment callback response verification failed'. The API Secret Key in HostBill does not match the one in your merchant dashboard. Copy it again and save. --- # Terima bayaran Bayarcash dalam HostBill > Install modul bayaran Bayarcash dalam HostBill dan masukkan portal key, token dan API secret key anda. > > Source: https://docs.bayarcash.com/ms/hostbill/ Dengan modul Bayarcash untuk HostBill, pelanggan anda boleh membayar invois melalui Bayarcash. Modul ini hanya menerima MYR. ## Sebelum anda mula Anda memerlukan perkara berikut: - Akaun merchant Bayarcash yang sudah diluluskan. - Fail modul Bayarcash untuk HostBill, daripada Bayarcash. - **Portal Key**, **Personal Access Token** dan **API Secret Key** anda. Lihat [Cari API keys anda](/ms/api-keys/) dan [Portal](/ms/portals/). - Akses ke fail server HostBill anda. Composer mesti ada pada server itu. ## Install modul Biasanya developer atau host anda yang membuat bahagian ini. Langkah-langkahnya: 1. Copy folder modul ke dalam folder HostBill anda, di bawah folder **includes/modules/Payment**. 2. Dalam folder modul itu, jalankan `composer install` untuk menambah library yang modul itu perlukan. 3. Dalam admin area HostBill, aktifkan **Bayarcash** dalam senarai modul bayaran. ## Masukkan keys anda Buka tetapan modul Bayarcash dan isi ruangan ini: | Ruangan | Apa yang perlu dimasukkan | |---|---| | **Portal Key** | Portal yang akan menerima bayaran. | | **Token** | Personal Access Token anda. | | **API Secret Key** | Secret key anda. Jangan kongsi key ini. | | **Use sandbox** | Tandakan hanya semasa ujian dengan keys sandbox. | Simpan tetapan itu. Di page bayaran, pelanggan anda boleh pilih **FPX**, **FPX Line of Credit** atau **DuitNow DOBW**. ## Tips Dua habit ini membantu anda dengan HostBill: - **Uji dalam sandbox dahulu.** Bayar satu invois ujian dengan keys sandbox. Kemudian, buang tanda pada **Use sandbox** dan tukar kepada keys live. - **Uji modul ini dalam versi HostBill anda sendiri.** Bayarcash tidak menyatakan versi minimum HostBill. Jadi, uji satu bayaran sebelum anda go live. ## Isu biasa ### Kenapa pelanggan saya nampak 'Payment failed, please contact administrator'? Semak Portal Key, Token dan API Secret Key dalam tetapan modul. Pastikan juga invois anda dalam MYR. Bayarcash hanya menerima MYR. ### Kenapa saya nampak 'Payment callback response verification failed' walaupun bayaran berjaya? API Secret Key dalam HostBill tidak sama dengan key dalam merchant dashboard anda. Copy key itu sekali lagi dan simpan. --- # 在HostBill接受Bayarcash付款 > 在HostBill安装Bayarcash付款模块,然后添加你的portal key、token和API secret key。 > > Source: https://docs.bayarcash.com/zh/hostbill/ HostBill的Bayarcash模块让你的客户通过Bayarcash支付发票。它只接受MYR。 ## 开始之前 你需要准备好: - 已获批准的Bayarcash商家账号。 - Bayarcash提供的HostBill模块文件。 - 你的**Portal Key**、**Personal Access Token**和**API Secret Key**。请参阅[找到你的API key](/zh/api-keys/)和[Portal](/zh/portals/)。 - HostBill服务器文件的访问权限,而且服务器上可以使用Composer。 ## 安装模块 这部分通常由你的开发者或主机商来做。步骤如下: 1. 把模块文件夹复制到你的HostBill安装文件夹,放在**includes/modules/Payment**文件夹下。 2. 在模块文件夹里运行`composer install`,添加模块需要的库。 3. 在HostBill管理后台,在付款模块中启用**Bayarcash**。 ## 添加你的key 打开Bayarcash模块设置,填写这些栏位: | 栏位 | 填写什么 | |---|---| | **Portal Key** | 接收这些付款的portal。 | | **Token** | 你的Personal Access Token。 | | **API Secret Key** | 你的secret key。不要告诉别人。 | | **Use sandbox** | 只在用sandbox key测试时勾选。 | 保存设置。在付款页面,客户可以选择**FPX**、**FPX Line of Credit**或**DuitNow DOBW**。 ## 小贴士 - **先在sandbox测试**。用sandbox key支付一张测试发票,然后取消勾选**Use sandbox**,换成正式key。 - **在你自己的HostBill版本检查模块**。Bayarcash没有列出最低的HostBill版本要求,所以正式上线前请先测试一笔付款。 ## 常见问题 ### 我的客户看到“Payment failed, please contact administrator”,为什么? 检查模块设置里的Portal Key、Token和API Secret Key,并确认你的发票用的是MYR。Bayarcash只接受MYR。 ### 付款成功了,但我看到“Payment callback response verification failed”,为什么? HostBill里的API Secret Key和你商家后台(merchant dashboard)里的不一样。重新复制它,然后保存。 --- # Accept Bayarcash payments in OpenCart > Install the Bayarcash module in OpenCart 3 or 4, add your keys, choose payment channels and test before going live. > > Source: https://docs.bayarcash.com/opencart/ The Bayarcash module lets your OpenCart shop take payments through Bayarcash. It comes as one zip file for OpenCart 3 and another for OpenCart 4. Use the one that matches your store. To see the module at work before you install it, try the [live demo](https://opencart.bayarcash-demo.com/). ## Before you start You need the following: - An approved Bayarcash merchant account with your payment channels enabled. - Your **Personal Access Token**, **API Secret** and **Portal Key**. See [API keys](/api-keys/) and [Portals](/portals/). - Malaysian Ringgit (MYR) set up as a currency in your store. ## Install the module Download the module zip file from the [Bayarcash plugin page](https://plugin.bayarcash.com/). Then: 1. In the OpenCart admin, go to **Extensions** → **Installer** and upload the zip. 2. Go to **Extensions** → **Extensions** and choose the **Payments** type. 3. Find **Bayarcash** in the list. Click **Install**, then **Edit**. ## Add your keys The settings open on the **API details** tab. To fill it in: 1. Keep or change **Payment Name**. This is the name customers see at checkout. 2. Paste your **Personal Access Token**, **API Secret** and **Portal Key**. 3. Leave **Sandbox Mode** off for real payments. Turn it on only with sandbox keys. 4. Save. OpenCart checks your token when you save. ## Choose channels and turn it on Next, open the **General** tab: 1. Under **Payment Channels**, select the channels to offer. Hold Ctrl or Cmd to pick several. 2. Set **Status** to on. 3. Save. Customers then see each channel at checkout, named after your **Payment Name**, for example "Bayarcash - Credit Card". ## Other settings These tabs are optional: | Tab | What it does | |---|---| | **Order status** | Sets the status for **Canceled Order Status**, **Failed Order Status** and **Paid Order Status**. | | **Customize checkout** | **Instruction** shows your own text before the customer pays. | | **Troubleshoot** | **Debug logging** writes details to the OpenCart error log. | ## Tips - **Test before you go live.** Turn on **Sandbox Mode** with sandbox keys, place one order, then turn it off and use your live keys. - **Check Sandbox Mode first if live payments fail.** It must be off for real payments. ## Common issues ### Checkout shows 'Bayarcash requires MYR currency to be set-up.' Add Malaysian Ringgit (MYR) as a currency in your store. Bayarcash processes MYR only. Other currencies work only if Convert To Processing is on. ### I cannot save the settings because of a missing field. Personal Access Token, API Secret, Portal Key and Payment Name are all required. If you turn on Instruction, Bayarcash Instructions is required too. ### Saving the settings shows the text error_invalid_token or error_pat_required. These are unfinished error messages. They mean the Personal Access Token is empty or Bayarcash did not accept it. Copy the token again from your merchant dashboard and save. ### Customers see 'Invalid redirect.' or 'Payment method is incorrect!' at checkout. Ask the customer to go back to checkout and choose the Bayarcash payment method again. If it keeps happening, turn on Debug logging on the Troubleshoot tab and share the OpenCart error log with support. --- # Terima bayaran Bayarcash dalam OpenCart > Install modul Bayarcash dalam OpenCart 3 atau 4, masukkan keys anda, pilih saluran bayaran dan buat ujian sebelum go live. > > Source: https://docs.bayarcash.com/ms/opencart/ Dengan modul Bayarcash, kedai OpenCart anda boleh menerima bayaran melalui Bayarcash. Modul ini ada dua fail zip: satu untuk OpenCart 3 dan satu lagi untuk OpenCart 4. Guna fail yang sepadan dengan versi kedai anda. Untuk melihat modul ini berfungsi sebelum anda install, cuba [demo langsung](https://opencart.bayarcash-demo.com/). ## Sebelum anda mula Anda memerlukan perkara berikut: - Akaun merchant Bayarcash yang sudah diluluskan, dengan saluran bayaran anda sudah di-on-kan. - **Personal Access Token**, **API Secret** dan **Portal Key** anda. Lihat [Cari API keys anda](/ms/api-keys/) dan [Portal](/ms/portals/). - Ringgit Malaysia (MYR) sebagai salah satu mata wang dalam kedai anda. ## Install modul Muat turun fail zip modul dari [page plugin Bayarcash](https://plugin.bayarcash.com/). Kemudian: 1. Dalam admin OpenCart, pergi ke **Extensions** → **Installer** dan upload fail zip itu. 2. Pergi ke **Extensions** → **Extensions** dan pilih jenis **Payments**. 3. Cari **Bayarcash** dalam senarai. Klik **Install**, kemudian **Edit**. ## Masukkan keys anda Tetapan dibuka pada tab **API details**. Untuk mengisinya: 1. Kekalkan atau tukar **Payment Name**. Pelanggan nampak nama ini semasa checkout. 2. Paste **Personal Access Token**, **API Secret** dan **Portal Key** anda. 3. Biarkan **Sandbox Mode** off untuk bayaran sebenar. On-kan hanya dengan keys sandbox. 4. Simpan. OpenCart menyemak token anda semasa anda simpan. ## Pilih saluran & aktifkan modul Seterusnya, buka tab **General**: 1. Di bawah **Payment Channels**, pilih saluran yang anda mahu tawarkan. Tekan Ctrl atau Cmd untuk memilih beberapa saluran. 2. Tetapkan **Status** kepada on. 3. Simpan. Semasa checkout, pelanggan nampak setiap saluran dengan nama mengikut **Payment Name** anda, contohnya "Bayarcash - Credit Card". ## Tetapan lain Tab-tab ini pilihan: | Tab | Fungsinya | |---|---| | **Order status** | Menetapkan status untuk **Canceled Order Status**, **Failed Order Status** dan **Paid Order Status**. | | **Customize checkout** | **Instruction** memaparkan teks anda sendiri sebelum pelanggan membayar. | | **Troubleshoot** | **Debug logging** menulis butiran ke log ralat OpenCart. | ## Tips Dua habit ini membantu anda dengan OpenCart: - **Uji sebelum anda go live.** On-kan **Sandbox Mode** dengan keys sandbox dan buat satu pesanan. Kemudian, off-kan suis itu dan guna keys live anda. - **Semak Sandbox Mode dahulu jika bayaran live gagal.** Sandbox Mode mesti off untuk bayaran sebenar. ## Isu biasa ### Kenapa checkout memaparkan 'Bayarcash requires MYR currency to be set-up.'? Tambah ringgit Malaysia (MYR) sebagai mata wang dalam kedai anda. Bayarcash hanya memproses MYR. Mata wang lain hanya berfungsi jika Convert To Processing di-on-kan. ### Kenapa saya tidak dapat menyimpan tetapan kerana ada ruangan yang kosong? Personal Access Token, API Secret, Portal Key dan Payment Name wajib diisi. Jika anda on-kan Instruction, Bayarcash Instructions juga wajib diisi. ### Kenapa saya nampak teks error_invalid_token atau error_pat_required semasa menyimpan tetapan? Ini mesej ralat yang belum siap. Maksudnya, Personal Access Token kosong, atau Bayarcash tidak menerima token itu. Copy token itu sekali lagi dari merchant dashboard anda dan simpan. ### Kenapa pelanggan nampak 'Invalid redirect.' atau 'Payment method is incorrect!' semasa checkout? Minta pelanggan kembali ke checkout dan pilih kaedah bayaran Bayarcash sekali lagi. Jika masalah ini berulang, on-kan Debug logging pada tab Troubleshoot dan kongsi log ralat OpenCart dengan team Bayarcash. --- # 在OpenCart接受Bayarcash付款 > 在OpenCart 3或4安装Bayarcash模块,添加你的key,选择付款渠道,正式上线前先测试。 > > Source: https://docs.bayarcash.com/zh/opencart/ Bayarcash模块让你的OpenCart商店通过Bayarcash收款。模块有两个zip文件,一个给OpenCart 3,另一个给OpenCart 4。请使用和你的商店版本相符的那一个。 想在安装前先看看模块怎样运作,可以试试[在线演示](https://opencart.bayarcash-demo.com/)。 ## 开始之前 你需要准备好: - 已获批准的Bayarcash商家账号,并已开启你的付款渠道。 - 你的**Personal Access Token**、**API Secret**和**Portal Key**。请参阅[找到你的API key](/zh/api-keys/)和[Portal](/zh/portals/)。 - 在你的商店设好马币(MYR)货币。 ## 安装模块 从[Bayarcash插件页面](https://plugin.bayarcash.com/)下载模块的zip文件。然后: 1. 在OpenCart管理后台,前往**Extensions** → **Installer**,然后上传zip文件。 2. 前往**Extensions** → **Extensions**,然后选择**Payments**类型。 3. 在列表里找到**Bayarcash**。点击**Install**,然后点击**Edit**。 ## 添加你的key 设置会在**API details**标签页打开。填写步骤: 1. 保留或更改**Payment Name**。这是顾客在结账时看到的名称。 2. 粘贴你的**Personal Access Token**、**API Secret**和**Portal Key**。 3. 收真实付款时,让**Sandbox Mode**保持关闭。只有使用sandbox key时才开启它。 4. 保存。保存时,OpenCart会检查你的token。 ## 选择渠道并开启模块 接着,打开**General**标签页: 1. 在**Payment Channels**下,选择要提供的渠道。按住Ctrl或Cmd可以选多个。 2. 把**Status**设为开启。 3. 保存。 之后顾客在结账时会看到每个渠道,名称按你的**Payment Name**显示,例如“Bayarcash - Credit Card”。 ## 其他设置 这些标签页是可选的: | 标签页 | 作用 | |---|---| | **Order status** | 设置**Canceled Order Status**、**Failed Order Status**和**Paid Order Status**的状态。 | | **Customize checkout** | **Instruction**在顾客付款前显示你自己的文字。 | | **Troubleshoot** | **Debug logging**把详细资料写入OpenCart错误日志。 | ## 小贴士 - **正式上线前先测试**。用sandbox key开启**Sandbox Mode**,下一个订单,然后关闭它,改用你的正式key。 - **正式付款失败时,先检查Sandbox Mode**。收真实付款时,它必须关闭。 ## 常见问题 ### 结账页面显示“Bayarcash requires MYR currency to be set-up.”,为什么? 在你的商店添加马币(MYR)作为货币。Bayarcash只处理MYR。只有开启Convert To Processing,其他货币才能使用。 ### 有栏位没填,所以无法保存设置,要填哪些? Personal Access Token、API Secret、Portal Key和Payment Name都是必填。如果你开启了Instruction,Bayarcash Instructions也是必填。 ### 保存设置时显示error_invalid_token或error_pat_required,这是什么? 这些是还没完成的错误信息,意思是Personal Access Token是空的,或Bayarcash不接受它。从你的商家后台(merchant dashboard)重新复制token,然后保存。 ### 顾客在结账时看到“Invalid redirect.”或“Payment method is incorrect!”,怎么办? 请顾客回到结账页面,再选一次Bayarcash付款方式。如果问题一直出现,在Troubleshoot标签页开启Debug logging,并把OpenCart错误日志发给支持团队。 --- # Accept Bayarcash payments in PrestaShop > Install the Bayarcash module in PrestaShop and enter your keys so your shop can take payments through Bayarcash. > > Source: https://docs.bayarcash.com/prestashop/ The Bayarcash module lets your PrestaShop store take payments through Bayarcash. Use this guide to install it and enter your keys. To see the module at work before you install it, try the [live demo](https://prestashop.bayarcash-demo.com/). ## Before you start You need the following: - An approved Bayarcash merchant account with your payment channels enabled. - Your **Personal Access Token (PAT)** and **API Secret Key**. See [API keys](/api-keys/). - Admin access to your PrestaShop store, with the shop currency set to Malaysian Ringgit (MYR). ## Install the module Download the [module zip file](https://bayarcash.com/wp-content/uploads/sites/2/2024/11/bayarcash.zip) from Bayarcash. Then: 1. In the PrestaShop admin, go to **Modules** → **Module Manager**. 2. Click **Upload a Module** and choose the zip file. 3. When it is installed, click **Configure**. ## Add your keys The Bayarcash configuration panel holds all the payment settings. To finish setup: 1. Enter your **Personal Access Token (PAT)** and **API Secret Key**. 2. Click **Verify Token** to confirm the keys are correct. 3. Turn off **Test Mode** before you accept real payments. 4. Save. ## Tips - **Test first.** Turn on **Test Mode** to try an order, then turn it off and use your live keys. - **Check transactions in Bayarcash.** Your payments and reports are in your merchant dashboard. See [Transactions](/transactions/). ## Common issues ### Payments fail after I set up the module. Turn off Test Mode for real payments, and check your Personal Access Token and API Secret Key. Use the Verify Token button to confirm them. Your shop currency must be Malaysian Ringgit (MYR). --- # Terima bayaran Bayarcash dalam PrestaShop > Install modul Bayarcash dalam PrestaShop dan masukkan keys anda supaya kedai anda boleh menerima bayaran melalui Bayarcash. > > Source: https://docs.bayarcash.com/ms/prestashop/ Dengan modul Bayarcash, kedai PrestaShop anda boleh menerima bayaran melalui Bayarcash. Panduan ini menerangkan cara install modul itu dan memasukkan keys anda. Untuk melihat modul ini berfungsi sebelum anda install, cuba [demo langsung](https://prestashop.bayarcash-demo.com/). ## Sebelum anda mula Anda memerlukan perkara berikut: - Akaun merchant Bayarcash yang sudah diluluskan, dengan saluran bayaran anda sudah di-on-kan. - **Personal Access Token (PAT)** dan **API Secret Key** anda. Lihat [Cari API keys anda](/ms/api-keys/). - Akses admin ke kedai PrestaShop anda, dengan mata wang kedai ringgit Malaysia (MYR). ## Install modul Muat turun [fail zip modul](https://bayarcash.com/wp-content/uploads/sites/2/2024/11/bayarcash.zip) daripada Bayarcash. Kemudian: 1. Dalam admin PrestaShop, pergi ke **Modules** → **Module Manager**. 2. Klik **Upload a Module** dan pilih fail zip itu. 3. Selepas modul di-install, klik **Configure**. ## Masukkan keys anda Semua tetapan bayaran ada dalam panel konfigurasi Bayarcash. Untuk melengkapkan tetapan: 1. Masukkan **Personal Access Token (PAT)** dan **API Secret Key** anda. 2. Klik **Verify Token** untuk mengesahkan keys itu betul. 3. Off-kan **Test Mode** sebelum anda menerima bayaran sebenar. 4. Simpan. ## Tips Dua habit ini membantu anda dengan PrestaShop: - **Uji dahulu.** On-kan **Test Mode** untuk mencuba satu pesanan. Kemudian, off-kan suis itu dan guna keys live anda. - **Semak transaksi dalam Bayarcash.** Bayaran dan laporan anda ada dalam merchant dashboard. Lihat [Transaksi](/ms/transactions/). ## Isu biasa ### Kenapa bayaran gagal selepas saya menyediakan modul ini? Off-kan Test Mode untuk bayaran sebenar, dan semak Personal Access Token dan API Secret Key anda. Klik butang Verify Token untuk mengesahkan keys itu. Mata wang kedai anda mesti ringgit Malaysia (MYR). --- # 在PrestaShop接受Bayarcash付款 > 在PrestaShop安装Bayarcash模块并输入你的key,让你的商店可以通过Bayarcash收款。 > > Source: https://docs.bayarcash.com/zh/prestashop/ Bayarcash模块让你的PrestaShop商店通过Bayarcash收款。这份指南教你安装模块并输入你的key。 想在安装前先看看模块怎样运作,可以试试[在线演示](https://prestashop.bayarcash-demo.com/)。 ## 开始之前 你需要准备好: - 已获批准的Bayarcash商家账号,并已开启你的付款渠道。 - 你的Personal Access Token (PAT)和**API Secret Key**。请参阅[找到你的API key](/zh/api-keys/)。 - PrestaShop商店的管理员权限,商店货币设为马币(MYR)。 ## 安装模块 从Bayarcash下载[模块zip文件](https://bayarcash.com/wp-content/uploads/sites/2/2024/11/bayarcash.zip)。然后: 1. 在PrestaShop管理后台,前往**Modules** → **Module Manager**。 2. 点击**Upload a Module**,然后选择zip文件。 3. 安装完成后,点击**Configure**。 ## 添加你的key 所有付款设置都在Bayarcash配置面板里。完成设置的步骤: 1. 输入你的Personal Access Token (PAT)和**API Secret Key**。 2. 点击**Verify Token**,确认key正确。 3. 收真实付款之前,关闭**Test Mode**。 4. 保存。 ## 小贴士 - **先测试**。开启**Test Mode**试下一个订单,然后关闭它,改用你的正式key。 - **在Bayarcash查看交易**。你的付款和报告都在商家后台(merchant dashboard)。请参阅[交易](/zh/transactions/)。 ## 常见问题 ### 设置模块后付款失败,为什么? 收真实付款时要关闭Test Mode,并检查你的Personal Access Token和API Secret Key。用Verify Token按钮确认它们正确。你的商店货币必须是马币(MYR)。 --- # Accept Bayarcash payments in EasyStore > Add Bayarcash as a payment method in your EasyStore admin using the details from your Bayarcash Team profile. > > Source: https://docs.bayarcash.com/easystore/ You can add Bayarcash as a payment method in your EasyStore shop, so customers can pay with the Bayarcash channels you have enabled. To see Bayarcash at the checkout of an EasyStore shop, try the [demo store](https://bayarcash-2.easy.co/). ## Before you start You need the following: - An approved Bayarcash merchant account with your payment channels enabled. - A bcl.my account. It is free for Bayarcash merchants. - Access to your EasyStore payment settings, with the store currency set to Malaysian Ringgit (MYR). ## Add Bayarcash to EasyStore Start in your EasyStore admin. To add the payment method: 1. Go to **Settings** → **Payments**. 2. Choose **Add payment method** and search for **Bayarcash**. You can also use the [Bayarcash link in EasyStore](https://admin.easystore.co/settings/gateway/bayarcash). ## Copy your details from bcl.my EasyStore asks for two values from your Team profile. To find them: 1. Log in to your bcl.my account. 2. Go to **Team** → **Team Profile**. 3. Copy your **Team ID** and your **Bayarcash API secret key**. 4. Paste them into the Bayarcash settings in EasyStore. Check the settings, save, then place a test order at your EasyStore checkout to confirm payment works. > **Caution** > Keep your secret key private. Never share it in a message or a screenshot. ## Tips - **Offer several channels.** You can switch on more than one Bayarcash channel, and customers choose at checkout. - **Find payments in Bayarcash.** Transactions and reports are in your merchant dashboard. See [Transactions](/transactions/). ## Common issues ### Payments fail with Transaction Failed or Payment Processing Error. Check that your EasyStore currency is Malaysian Ringgit (MYR), because Bayarcash processes MYR only. Then check that the Team ID and secret key you pasted are correct. --- # Terima bayaran Bayarcash dalam EasyStore > Tambah Bayarcash sebagai kaedah bayaran dalam admin EasyStore anda dengan butiran dari Team profile Bayarcash anda. > > Source: https://docs.bayarcash.com/ms/easystore/ Anda boleh menambah Bayarcash sebagai kaedah bayaran dalam kedai EasyStore anda. Pelanggan boleh membayar dengan saluran Bayarcash yang anda sudah on-kan. Untuk melihat Bayarcash semasa checkout di kedai EasyStore, cuba [kedai demo](https://bayarcash-2.easy.co/). ## Sebelum anda mula Anda memerlukan perkara berikut: - Akaun merchant Bayarcash yang sudah diluluskan, dengan saluran bayaran anda sudah di-on-kan. - Akaun bcl.my. Akaun ini percuma untuk merchant Bayarcash. - Akses ke tetapan bayaran EasyStore anda, dengan mata wang kedai ringgit Malaysia (MYR). ## Tambah Bayarcash pada EasyStore Mula dalam admin EasyStore anda. Untuk menambah kaedah bayaran: 1. Pergi ke **Settings** → **Payments**. 2. Klik **Add payment method** dan cari **Bayarcash**. Anda juga boleh guna [link Bayarcash dalam EasyStore](https://admin.easystore.co/settings/gateway/bayarcash). ## Copy butiran anda dari bcl.my EasyStore meminta dua nilai dari Team profile anda. Untuk mendapatkannya: 1. Log masuk ke akaun bcl.my anda. 2. Pergi ke **Team** → **Team Profile**. 3. Copy **Team ID** dan **Bayarcash API secret key** anda. 4. Paste kedua-duanya ke dalam tetapan Bayarcash dalam EasyStore. Semak tetapan dan simpan. Kemudian, buat satu pesanan ujian di checkout EasyStore anda untuk memastikan bayaran berfungsi. > **Caution** > Jangan kongsi secret key anda. Jangan hantar key itu dalam mesej atau screenshot. ## Tips Dua habit ini membantu anda dengan EasyStore: - **Tawarkan beberapa saluran.** Anda boleh on-kan lebih daripada satu saluran Bayarcash, dan pelanggan memilih saluran semasa checkout. - **Cari bayaran dalam Bayarcash.** Transaksi dan laporan ada dalam merchant dashboard anda. Lihat [Transaksi](/ms/transactions/). ## Isu biasa ### Kenapa bayaran gagal dengan mesej Transaction Failed atau Payment Processing Error? Pastikan mata wang EasyStore anda ialah ringgit Malaysia (MYR), kerana Bayarcash hanya memproses MYR. Kemudian, semak Team ID dan secret key yang anda paste. Kedua-duanya mesti betul. --- # 在EasyStore接受Bayarcash付款 > 在EasyStore管理后台把Bayarcash添加为付款方式,使用你Bayarcash Team profile里的资料。 > > Source: https://docs.bayarcash.com/zh/easystore/ 你可以在EasyStore商店把Bayarcash添加为付款方式,让顾客用你已开启的Bayarcash渠道付款。 想看看Bayarcash在EasyStore商店结账时的样子,可以试试[演示商店](https://bayarcash-2.easy.co/)。 ## 开始之前 你需要准备好: - 已获批准的Bayarcash商家账号,并已开启你的付款渠道。 - 一个bcl.my账号。Bayarcash商家可以免费使用。 - EasyStore付款设置的访问权限,商店货币设为马币(MYR)。 ## 把Bayarcash添加到EasyStore 从你的EasyStore管理后台开始。添加付款方式的步骤: 1. 前往**Settings** → **Payments**。 2. 选择**Add payment method**,然后搜索**Bayarcash**。你也可以使用[EasyStore里的Bayarcash链接](https://admin.easystore.co/settings/gateway/bayarcash)。 ## 从bcl.my复制你的资料 EasyStore需要你Team profile里的两项资料。查找步骤: 1. 登录你的bcl.my账号。 2. 前往**Team** → **Team Profile**。 3. 复制你的**Team ID**和**Bayarcash API secret key**。 4. 把它们粘贴到EasyStore的Bayarcash设置里。 检查设置并保存,然后在你的EasyStore结账页面下一个测试订单,确认付款正常。 > **Caution** > 不要把你的secret key告诉别人。不要在信息或截图里分享它。 ## 小贴士 - **提供多个渠道**。你可以开启多个Bayarcash渠道,让顾客在结账时自己选择。 - **在Bayarcash查找付款**。交易和报告都在你的商家后台(merchant dashboard)。请参阅[交易](/zh/transactions/)。 ## 常见问题 ### 付款失败,显示Transaction Failed或Payment Processing Error,为什么? 检查你的EasyStore货币是否是马币(MYR),因为Bayarcash只处理MYR。然后检查你粘贴的Team ID和secret key是否正确。 --- # Connect HighLevel to Bayarcash > Install the Bayarcash app from the HighLevel Marketplace, paste your keys and take MYR payments in your funnels, invoices, forms and store. > > Source: https://docs.bayarcash.com/highlevel/ The Bayarcash app for HighLevel adds Bayarcash as a payment provider in your HighLevel account. Your customers pay in MYR. They can use FPX, DuitNow, buy now pay later, credit cards, Line of Credit, e-wallets and Cross-Border QR. The app works with your order forms, funnels, invoices, payment links and online store. ## How your customer pays 1. Your customer clicks **Pay** at checkout. 2. A new tab opens with the secure Bayarcash checkout. Your customer pays there with a channel that is enabled on your Bayarcash account. 3. When the bank approves the payment, HighLevel marks the order as paid automatically. ## Before you start You need these before you set up the app: - An approved Bayarcash merchant account. To get one, see [Sign up for Bayarcash](/sign-up/). - Your **Personal Access Token (PAT)** and **API Secret Key**. See [Find your API keys](/api-keys/). - A HighLevel account where you can install apps. ## Install the app [Install the Bayarcash app from the HighLevel Marketplace](https://marketplace.gohighlevel.com/integration/6abb57bff9fc8bc28d7b0e9e). The app is free. After the installation, test mode works immediately on the Bayarcash sandbox. You do not need sandbox keys to try a payment. ## Add your keys 1. Open the app's **Configuration** tab. 2. Paste your **Personal Access Token (PAT)** and **API Secret Key**. Your portal loads automatically. 3. Save to go live. Use the keys from your live merchant dashboard. If the app does not accept the keys, make sure that you copied all of each key. See [Find your API keys](/api-keys/). ## Choose test or live payments On each payment link, invoice or form, choose **Test** or **Live** under **Payment Mode**. - **Test** uses the Bayarcash sandbox. No real money moves. - **Live** takes real payments into your Bayarcash account. Make a test payment before you share a live link with customers. ## Good to know - **One-time payments in MYR.** Each payment must be from RM 1.00 to RM 30,000.00. - **Refunds.** Refund your customers from your own bank account. - **Subscriptions.** Bayarcash will add recurring payments to the app later. - **Customers without an email** can still pay when you set a fallback email. - **Payments appear in Transactions** on your Bayarcash merchant dashboard. See [Transactions](/transactions/). - **A channel works only if it is enabled on your account.** See [Payment channels](/payment-channels/). ## Common issues ### A customer asks for a refund. Can I refund from HighLevel? No. The Bayarcash app does not send refunds. Refund the customer from your own bank account. ### Can I charge a subscription or a recurring payment? Not yet. The app takes one-time payments only. Bayarcash will add recurring payments to the app later. ### My customer cannot pay because the amount is not in MYR. Bayarcash takes payments in Malaysian ringgit (MYR) only, from RM 1.00 to RM 30,000.00. Set the currency of the order, invoice or form to MYR. ### My customer has no email address. Can they still pay? Yes. Set a fallback email in the app. Bayarcash uses it when the checkout does not have the customer's email. --- # Sambungkan HighLevel kepada Bayarcash > Install app Bayarcash dari HighLevel Marketplace, paste keys anda dan terima bayaran MYR dalam funnel, invois, form dan kedai anda. > > Source: https://docs.bayarcash.com/ms/highlevel/ App Bayarcash untuk HighLevel menambah Bayarcash sebagai payment provider dalam akaun HighLevel anda. Pelanggan anda membayar dalam MYR. Mereka boleh menggunakan FPX, DuitNow, buy now pay later, kad kredit, Line of Credit, e-wallet dan Cross-Border QR. App ini berfungsi dengan order form, funnel, invois, payment link dan kedai online anda. ## Cara pelanggan anda membayar 1. Pelanggan anda klik **Pay** semasa checkout. 2. Tab baru dibuka dengan checkout Bayarcash yang selamat. Pelanggan anda membayar di situ dengan saluran yang di-on-kan pada akaun Bayarcash anda. 3. Apabila bank meluluskan bayaran itu, HighLevel menandakan pesanan itu sebagai sudah dibayar secara automatik. ## Sebelum anda mula Sediakan perkara ini sebelum anda menyediakan app itu: - Akaun merchant Bayarcash yang sudah diluluskan. Untuk mendapatkannya, lihat [Daftar akaun Bayarcash](/ms/sign-up/). - **Personal Access Token (PAT)** dan **API Secret Key** anda. Lihat [Cari API keys anda](/ms/api-keys/). - Akaun HighLevel yang membenarkan anda install app. ## Install app [Install app Bayarcash dari HighLevel Marketplace](https://marketplace.gohighlevel.com/integration/6abb57bff9fc8bc28d7b0e9e). App ini percuma. Selepas install, test mode terus berfungsi pada sandbox Bayarcash. Anda tidak perlu keys sandbox untuk mencuba bayaran. ## Masukkan keys anda 1. Buka tab **Configuration** dalam app itu. 2. Paste **Personal Access Token (PAT)** dan **API Secret Key** anda. Portal anda dimuatkan secara automatik. 3. Simpan untuk go live. Guna keys dari merchant dashboard live anda. Jika app itu tidak menerima keys anda, pastikan anda copy setiap key dengan lengkap. Lihat [Cari API keys anda](/ms/api-keys/). ## Pilih bayaran ujian atau bayaran live Pada setiap payment link, invois atau form, pilih **Test** atau **Live** di bawah **Payment Mode**. - **Test** menggunakan sandbox Bayarcash. Tiada wang sebenar yang bergerak. - **Live** menerima bayaran sebenar ke dalam akaun Bayarcash anda. Buat satu bayaran ujian sebelum anda kongsi link live dengan pelanggan. ## Perkara yang perlu anda tahu - **Bayaran sekali sahaja dalam MYR.** Setiap bayaran mesti dari RM 1.00 hingga RM 30,000.00. - **Refund.** Refund pelanggan anda dari akaun bank anda sendiri. - **Langganan.** Bayarcash akan menambah bayaran berulang pada app ini kemudian. - **Pelanggan tanpa e-mel** masih boleh membayar jika anda menetapkan fallback email. - **Bayaran dipaparkan dalam Transactions** dalam merchant dashboard Bayarcash anda. Lihat [Semak transaksi dan statusnya](/ms/transactions/). - **Sesuatu saluran hanya berfungsi jika saluran itu di-on-kan pada akaun anda.** Lihat [Saluran bayaran](/ms/payment-channels/). ## Isu biasa ### Bolehkah saya refund pelanggan dari HighLevel? Tidak boleh. App Bayarcash tidak menghantar refund. Refund pelanggan anda dari akaun bank anda sendiri. ### Bolehkah saya caj langganan atau bayaran berulang? Belum boleh. App ini hanya menerima bayaran sekali sahaja. Bayarcash akan menambah bayaran berulang pada app ini kemudian. ### Kenapa pelanggan saya tidak boleh membayar apabila amaun itu bukan dalam MYR? Bayarcash hanya menerima bayaran dalam ringgit Malaysia (MYR), dari RM 1.00 hingga RM 30,000.00. Tetapkan mata wang pesanan, invois atau form itu kepada MYR. ### Bolehkah pelanggan yang tiada alamat e-mel membayar? Boleh. Tetapkan fallback email dalam app itu. Bayarcash menggunakan e-mel itu apabila checkout tiada e-mel pelanggan. --- # 把HighLevel连接到Bayarcash > 从HighLevel Marketplace安装Bayarcash App,粘贴你的key,在funnel、发票、表单和网店收取MYR付款。 > > Source: https://docs.bayarcash.com/zh/highlevel/ HighLevel的Bayarcash App把Bayarcash添加为你HighLevel账号中的付款服务商(payment provider)。你的顾客以MYR付款。他们可以使用FPX、DuitNow、先买后付(BNPL)、信用卡、Line of Credit、电子钱包和Cross-Border QR。这个App适用于你的订单表单、funnel、发票、付款链接和网店。 ## 顾客如何付款 1. 顾客在结账时点击**Pay**。 2. 新标签页会打开安全的Bayarcash结账页面。顾客在那里用你Bayarcash账号已开通的渠道付款。 3. 银行批准付款后,HighLevel会自动把订单标为已付。 ## 开始之前 设置App之前,你需要准备: - 一个已获批准的Bayarcash商家账号。如果还没有,请参阅[注册Bayarcash](/zh/sign-up/)。 - 你的Personal Access Token (PAT)和**API Secret Key**。请参阅[找到你的API key](/zh/api-keys/)。 - 一个可以安装App的HighLevel账号。 ## 安装App [从HighLevel Marketplace安装Bayarcash App](https://marketplace.gohighlevel.com/integration/6abb57bff9fc8bc28d7b0e9e)。这个App是免费的。 安装后,测试模式会马上在Bayarcash sandbox上运作。你不需要sandbox key就能试付款。 ## 添加你的key 1. 打开App的**Configuration**标签页。 2. 粘贴你的Personal Access Token (PAT)和**API Secret Key**。你的portal会自动载入。 3. 保存即可正式上线。 请使用你正式商家后台(merchant dashboard)的key。如果App不接受这些key,请确认你完整复制了每个key。请参阅[找到你的API key](/zh/api-keys/)。 ## 选择测试或正式付款 在每个付款链接、发票或表单的**Payment Mode**下,选择**Test**或**Live**。 - **Test**使用Bayarcash sandbox,不会产生真实交易。 - **Live**把真实付款收进你的Bayarcash账号。 把正式链接分享给顾客之前,先做一笔测试付款。 ## 须知事项 - **以MYR收取一次性付款。** 每笔付款必须在RM 1.00到RM 30,000.00之间。 - **退款。** 请从你自己的银行账户退款给顾客。 - **订阅。** Bayarcash以后会在App中加入定期付款。 - **没有电邮的顾客**只要你设置了备用电邮,仍然可以付款。 - **付款会显示在商家后台。** 你可以在Bayarcash商家后台的**Transactions**中找到它们。请参阅[交易](/zh/transactions/)。 - **渠道必须在你的账号开通后才能使用。** 请参阅[付款渠道](/zh/payment-channels/)。 ## 常见问题 ### 顾客要求退款。我可以在HighLevel退款吗? 不可以。Bayarcash App不会发送退款。请从你自己的银行账户退款给顾客。 ### 我可以收取订阅或定期付款吗? 暂时不可以。这个App只收取一次性付款。Bayarcash以后会在App中加入定期付款。 ### 金额不是MYR,所以我的顾客无法付款。 Bayarcash只收取马来西亚令吉(MYR)付款,金额从RM 1.00到RM 30,000.00。请把订单、发票或表单的货币设为MYR。 ### 我的顾客没有电邮地址。他们还能付款吗? 可以。在App中设置一个备用电邮(fallback email)。当结账页面没有顾客的电邮时,Bayarcash会使用这个电邮。 --- # Use Bayarcash in Make > Add the Bayarcash app to your Make organization with its invitation link, connect your account and use Bayarcash in your scenarios. > > Source: https://docs.bayarcash.com/make/ [Make](https://www.make.com) (formerly Integromat) connects apps in visual workflows called scenarios. The Bayarcash app for Make lets a scenario work with your Bayarcash account without code. ## Before you start You need these before you add the app: - A Make account. The app installs in one of your Make organizations. - An approved Bayarcash merchant account, or a sandbox account for tests. - Your Bayarcash keys from the merchant dashboard. See [Find your API keys](/api-keys/). ## Add the Bayarcash app to Make Bayarcash shares its Make app with an invitation link, not through the public Make app list. To add it: 1. Sign in to Make. 2. Open the [Bayarcash invitation link](https://www.make.com/en/hq/app-invitation/2b07ed861f787c1e498d49d681944314). 3. Choose the organization where you build your scenarios. 4. Install the app. The app is then available in that organization only. For another organization, open the link again. ## Connect your Bayarcash account Make asks for a connection the first time you use a Bayarcash module. To make the connection: 1. In a scenario, add a module and search for **Bayarcash**. 2. Choose the module that you need. 3. Create a new connection and enter the Bayarcash keys that it asks for. 4. Save the connection. Use sandbox keys while you test. Change to live keys only when a test payment works from start to end. ## Receive payment results in Make Bayarcash sends the result of each payment to the callback URL of that payment. To act on the result in Make: 1. Start a second scenario with the **Webhooks** app of Make, and copy its address. 2. When you create the payment, put that address in the callback URL field, if the module has one. 3. Verify the `checksum` with your API Secret Key before you trust the data. See [Verify callbacks and checksums](/callbacks-and-checksum/). ## Tips - **Keep the order number unique for each payment.** It links each callback to the row that started the scenario. - **Use one connection for each environment.** Give each connection a clear name, so a test never uses live keys. ## Common issues ### I cannot find Bayarcash when I add a module to a scenario. Why? The Bayarcash app is not in the public Make app list. It is shared with an invitation link. Open the invitation link (https://www.make.com/en/hq/app-invitation/2b07ed861f787c1e498d49d681944314) again and install the app in the organization where you build the scenario. ### The invitation link only shows a Make sign-in page. What do I do? Sign in to Make, or create a Make account. Then open the invitation link again. The app installs in a Make organization, so you must sign in first. ### Which Bayarcash keys does the connection need? Use the keys from the same merchant dashboard as the payments: the sandbox keys for tests and the live keys for real payments. See Find your API keys (/api-keys/). --- # Guna Bayarcash dalam Make > Tambah app Bayarcash ke organisasi Make anda dengan link jemputan, sambungkan akaun anda dan guna Bayarcash dalam scenario anda. > > Source: https://docs.bayarcash.com/ms/make/ [Make](https://www.make.com) (dahulu Integromat) menyambungkan app dalam workflow visual yang dipanggil scenario. Dengan app Bayarcash untuk Make, scenario anda boleh berhubung dengan akaun Bayarcash anda tanpa kod. ## Sebelum anda mula Sediakan perkara ini sebelum anda menambah app itu: - Akaun Make. App ini di-install dalam salah satu organisasi Make anda. - Akaun merchant Bayarcash yang sudah diluluskan, atau akaun sandbox untuk ujian. - Keys Bayarcash anda dari merchant dashboard. Lihat [Cari API keys anda](/ms/api-keys/). ## Tambah app Bayarcash ke Make Bayarcash berkongsi app Make-nya melalui link jemputan, bukan melalui senarai app awam Make. Untuk menambah app itu: 1. Log masuk ke Make. 2. Buka [link jemputan Bayarcash](https://www.make.com/en/hq/app-invitation/2b07ed861f787c1e498d49d681944314). 3. Pilih organisasi tempat anda membina scenario. 4. Install app itu. App itu kini boleh digunakan dalam organisasi itu sahaja. Untuk organisasi lain, buka link itu semula. ## Sambungkan akaun Bayarcash anda Make akan meminta sambungan kali pertama anda menggunakan module Bayarcash. Untuk membuat sambungan itu: 1. Dalam scenario, tambah module dan cari **Bayarcash**. 2. Pilih module yang anda perlukan. 3. Cipta sambungan baru dan masukkan keys Bayarcash yang diminta. 4. Simpan sambungan itu. Guna keys sandbox semasa anda menguji. Tukar kepada keys live hanya selepas satu bayaran ujian berjaya dari mula hingga akhir. ## Terima keputusan bayaran dalam Make Bayarcash menghantar keputusan setiap bayaran ke callback URL bayaran itu. Untuk bertindak atas keputusan itu dalam Make: 1. Mulakan scenario kedua dengan app **Webhooks** Make, dan copy alamatnya. 2. Semasa anda mencipta bayaran, masukkan alamat itu dalam ruangan callback URL, jika module itu ada ruangan ini. 3. Sahkan `checksum` dengan API Secret Key anda sebelum anda mempercayai data itu. Lihat [Sahkan callback dan checksum](/ms/callbacks-and-checksum/). ## Tips - **Guna nombor pesanan yang unik untuk setiap bayaran.** Dengan nombor ini, anda boleh padankan setiap callback dengan row yang memulakan scenario itu. - **Guna satu sambungan untuk setiap environment.** Beri setiap sambungan nama yang jelas, supaya ujian tidak menggunakan keys live. ## Isu biasa ### Kenapa saya tidak jumpa Bayarcash semasa menambah module pada scenario? App Bayarcash tiada dalam senarai app awam Make. App ini dikongsi melalui link jemputan. Buka link jemputan (https://www.make.com/en/hq/app-invitation/2b07ed861f787c1e498d49d681944314) itu semula dan install app itu dalam organisasi tempat anda membina scenario. ### Kenapa link jemputan itu hanya memaparkan page log masuk Make? Log masuk ke Make, atau daftar akaun Make. Kemudian buka link jemputan itu semula. App ini di-install dalam organisasi Make, jadi anda perlu log masuk dahulu. ### Keys Bayarcash yang mana perlu untuk sambungan ini? Guna keys dari merchant dashboard yang sama dengan bayaran itu: keys sandbox untuk ujian, dan keys live untuk bayaran sebenar. Lihat Cari API keys anda (/ms/api-keys/). --- # 在Make中使用Bayarcash > 用邀请链接把Bayarcash App添加到你的Make organization,连接账号,然后在scenario中使用Bayarcash。 > > Source: https://docs.bayarcash.com/zh/make/ [Make](https://www.make.com)(前称Integromat)用名为scenario的可视化工作流程连接各种App。Make的Bayarcash App让scenario不用写代码,就能与你的Bayarcash账号配合使用。 ## 开始之前 添加App之前,你需要准备: - 一个Make账号。App会安装在你其中一个Make organization中。 - 一个已获批准的Bayarcash商家账号,或用于测试的sandbox账号。 - 你在商家后台(merchant dashboard)的Bayarcash key。请参阅[找到你的API key](/zh/api-keys/)。 ## 把Bayarcash App添加到Make Bayarcash通过邀请链接分享它的Make App,而不是通过Make的公开App列表。添加步骤如下: 1. 登录Make。 2. 打开[Bayarcash邀请链接](https://www.make.com/en/hq/app-invitation/2b07ed861f787c1e498d49d681944314)。 3. 选择你搭建scenario的organization。 4. 安装App。 之后,App只能在那个organization中使用。如果要用在其他organization,请再次打开链接。 ## 连接你的Bayarcash账号 你第一次使用Bayarcash module时,Make会要求你建立连接。建立连接的步骤如下: 1. 在scenario中添加一个module,然后搜索**Bayarcash**。 2. 选择你需要的module。 3. 创建新连接,然后输入它要求的Bayarcash key。 4. 保存连接。 测试时使用sandbox key。等一笔测试付款从头到尾顺利完成后,才换成正式key。 ## 在Make接收付款结果 Bayarcash会把每笔付款的结果发送到该付款的callback URL。要在Make根据结果执行操作: 1. 用Make的**Webhooks** App开始第二个scenario,并复制它的地址。 2. 创建付款时,如果module有callback URL栏位,就把这个地址填进去。 3. 先用你的API Secret Key验证`checksum`,再信任这些资料。请参阅[验证callback和checksum](/zh/callbacks-and-checksum/)。 ## 小贴士 - **每笔付款使用唯一的订单号码。** 它把每个callback对应回启动scenario的那一行。 - **每个环境使用一个连接。** 给每个连接取一个清楚的名称,这样测试就不会用到正式key。 ## 常见问题 ### 在scenario添加module时,我找不到Bayarcash。为什么? Bayarcash App不在Make的公开App列表中,它是通过邀请链接分享的。请再次打开邀请链接 (https://www.make.com/en/hq/app-invitation/2b07ed861f787c1e498d49d681944314),并把App安装在你搭建scenario的organization中。 ### 邀请链接只显示Make的登录页面。我该怎么办? 登录Make,或注册一个Make账号,然后再次打开邀请链接。App会安装在Make organization中,所以你必须先登录。 ### 连接需要哪些Bayarcash key? 使用与付款同一个商家后台的key:测试用sandbox key,真实付款用正式key。请参阅找到你的API key (/zh/api-keys/)。 --- # Use Bayarcash in Boost.Space > Add the Bayarcash app to Boost.Space Integrator with its invitation link, connect your account and use Bayarcash in your scenarios. > > Source: https://docs.bayarcash.com/boost-space/ [Boost.Space](https://boost.space) is a platform for data and automation. Its Integrator builds visual workflows called scenarios. The Bayarcash app for Boost.Space Integrator lets a scenario work with your Bayarcash account without code. ## Before you start You need these before you add the app: - A Boost.Space account with access to Integrator. - An approved Bayarcash merchant account, or a sandbox account for tests. - Your Bayarcash keys from the merchant dashboard. See [Find your API keys](/api-keys/). ## Add the Bayarcash app Bayarcash shares its Boost.Space app with an invitation link. To add it: 1. Sign in to Boost.Space. 2. Open the [Bayarcash invitation link](https://integrator.boost.space/app/invite/adcf82114e0d7042cbe2471d4f200cc8). 3. Install the app. ## Connect your Bayarcash account Integrator asks for a connection the first time you use a Bayarcash module. To make the connection: 1. In a scenario, add a module and search for **Bayarcash**. 2. Choose the module that you need. 3. Create a new connection and enter the Bayarcash keys that it asks for. 4. Save the connection. Use sandbox keys while you test. Change to live keys only when a test payment works from start to end. ## Receive payment results Bayarcash sends the result of each payment to the callback URL of that payment. To act on the result in Boost.Space: 1. Start a second scenario with a webhook trigger, and copy its address. 2. When you create the payment, put that address in the callback URL field, if the module has one. 3. Verify the `checksum` with your API Secret Key before you trust the data. See [Verify callbacks and checksums](/callbacks-and-checksum/). ## Tips - **Keep the order number unique for each payment.** It links each callback to the record that started the scenario. - **Use one connection for each environment.** Give each connection a clear name, so a test never uses live keys. ## Common issues ### I cannot find Bayarcash when I add a module. Why? The Bayarcash app is shared with an invitation link. Open the invitation link (https://integrator.boost.space/app/invite/adcf82114e0d7042cbe2471d4f200cc8) again while you are signed in to Boost.Space, and install the app. ### Which Bayarcash keys does the connection need? Use the keys from the same merchant dashboard as the payments: the sandbox keys for tests and the live keys for real payments. See Find your API keys (/api-keys/). ### Is this the same app as the Make app? Boost.Space and Make each have their own invitation link. Install the app on the platform where you build your scenarios. For Make, see Use Bayarcash in Make (/make/). --- # Guna Bayarcash dalam Boost.Space > Tambah app Bayarcash ke Boost.Space Integrator dengan link jemputan, sambungkan akaun anda dan guna Bayarcash dalam scenario anda. > > Source: https://docs.bayarcash.com/ms/boost-space/ [Boost.Space](https://boost.space) ialah platform untuk data dan automasi. Integrator-nya membina workflow visual yang dipanggil scenario. Dengan app Bayarcash untuk Boost.Space Integrator, scenario anda boleh berhubung dengan akaun Bayarcash anda tanpa kod. ## Sebelum anda mula Sediakan perkara ini sebelum anda menambah app itu: - Akaun Boost.Space yang ada akses kepada Integrator. - Akaun merchant Bayarcash yang sudah diluluskan, atau akaun sandbox untuk ujian. - Keys Bayarcash anda dari merchant dashboard. Lihat [Cari API keys anda](/ms/api-keys/). ## Tambah app Bayarcash Bayarcash berkongsi app Boost.Space-nya melalui link jemputan. Untuk menambah app itu: 1. Log masuk ke Boost.Space. 2. Buka [link jemputan Bayarcash](https://integrator.boost.space/app/invite/adcf82114e0d7042cbe2471d4f200cc8). 3. Install app itu. ## Sambungkan akaun Bayarcash anda Integrator akan meminta sambungan kali pertama anda menggunakan module Bayarcash. Untuk membuat sambungan itu: 1. Dalam scenario, tambah module dan cari **Bayarcash**. 2. Pilih module yang anda perlukan. 3. Cipta sambungan baru dan masukkan keys Bayarcash yang diminta. 4. Simpan sambungan itu. Guna keys sandbox semasa anda menguji. Tukar kepada keys live hanya selepas satu bayaran ujian berjaya dari mula hingga akhir. ## Terima keputusan bayaran Bayarcash menghantar keputusan setiap bayaran ke callback URL bayaran itu. Untuk bertindak atas keputusan itu dalam Boost.Space: 1. Mulakan scenario kedua dengan trigger webhook, dan copy alamatnya. 2. Semasa anda mencipta bayaran, masukkan alamat itu dalam ruangan callback URL, jika module itu ada ruangan ini. 3. Sahkan `checksum` dengan API Secret Key anda sebelum anda mempercayai data itu. Lihat [Sahkan callback dan checksum](/ms/callbacks-and-checksum/). ## Tips - **Guna nombor pesanan yang unik untuk setiap bayaran.** Dengan nombor ini, anda boleh padankan setiap callback dengan rekod yang memulakan scenario itu. - **Guna satu sambungan untuk setiap environment.** Beri setiap sambungan nama yang jelas, supaya ujian tidak menggunakan keys live. ## Isu biasa ### Kenapa saya tidak jumpa Bayarcash semasa menambah module? App Bayarcash dikongsi melalui link jemputan. Log masuk ke Boost.Space, buka link jemputan (https://integrator.boost.space/app/invite/adcf82114e0d7042cbe2471d4f200cc8) itu semula, dan install app itu. ### Keys Bayarcash yang mana perlu untuk sambungan ini? Guna keys dari merchant dashboard yang sama dengan bayaran itu: keys sandbox untuk ujian, dan keys live untuk bayaran sebenar. Lihat Cari API keys anda (/ms/api-keys/). ### Adakah app ini sama dengan app Make? Boost.Space dan Make masing-masing ada link jemputan sendiri. Install app itu pada platform tempat anda membina scenario. Untuk Make, lihat Guna Bayarcash dalam Make (/ms/make/). --- # 在Boost.Space中使用Bayarcash > 用邀请链接把Bayarcash App添加到Boost.Space Integrator,连接账号,然后在scenario中使用Bayarcash。 > > Source: https://docs.bayarcash.com/zh/boost-space/ [Boost.Space](https://boost.space)是一个数据与自动化平台。它的Integrator可以搭建名为scenario的可视化工作流程。Boost.Space Integrator的Bayarcash App让scenario不用写代码,就能与你的Bayarcash账号配合使用。 ## 开始之前 添加App之前,你需要准备: - 一个可以使用Integrator的Boost.Space账号。 - 一个已获批准的Bayarcash商家账号,或用于测试的sandbox账号。 - 你在商家后台(merchant dashboard)的Bayarcash key。请参阅[找到你的API key](/zh/api-keys/)。 ## 添加Bayarcash App Bayarcash通过邀请链接分享它的Boost.Space App。添加步骤如下: 1. 登录Boost.Space。 2. 打开[Bayarcash邀请链接](https://integrator.boost.space/app/invite/adcf82114e0d7042cbe2471d4f200cc8)。 3. 安装App。 ## 连接你的Bayarcash账号 你第一次使用Bayarcash module时,Integrator会要求你建立连接。建立连接的步骤如下: 1. 在scenario中添加一个module,然后搜索**Bayarcash**。 2. 选择你需要的module。 3. 创建新连接,然后输入它要求的Bayarcash key。 4. 保存连接。 测试时使用sandbox key。等一笔测试付款从头到尾顺利完成后,才换成正式key。 ## 接收付款结果 Bayarcash会把每笔付款的结果发送到该付款的callback URL。要在Boost.Space根据结果执行操作: 1. 用webhook触发器开始第二个scenario,并复制它的地址。 2. 创建付款时,如果module有callback URL栏位,就把这个地址填进去。 3. 先用你的API Secret Key验证`checksum`,再信任这些资料。请参阅[验证callback和checksum](/zh/callbacks-and-checksum/)。 ## 小贴士 - **每笔付款使用唯一的订单号码。** 它把每个callback对应回启动scenario的那条记录。 - **每个环境使用一个连接。** 给每个连接取一个清楚的名称,这样测试就不会用到正式key。 ## 常见问题 ### 添加module时,我找不到Bayarcash。为什么? Bayarcash App是通过邀请链接分享的。请在登录Boost.Space的状态下,再次打开邀请链接 (https://integrator.boost.space/app/invite/adcf82114e0d7042cbe2471d4f200cc8),然后安装App。 ### 连接需要哪些Bayarcash key? 使用与付款同一个商家后台的key:测试用sandbox key,真实付款用正式key。请参阅找到你的API key (/zh/api-keys/)。 ### 这个App和Make的App是同一个吗? Boost.Space和Make各有自己的邀请链接。请在你搭建scenario的平台上安装App。Make的设置请参阅在Make中使用Bayarcash (/zh/make/)。 --- # Bayarcash API documentation and sandbox > Start with Bayarcash API v3: the sandbox and production base URLs, how to sign each request with your Personal Access Token, and what API errors mean. > > Source: https://docs.bayarcash.com/developers/ The Bayarcash API lets your own website or app create payments, check transactions and manage Direct Debit mandates. Use **API v3** for everything new. The full reference is at [api-reference.bayarcash.com](https://api-reference.bayarcash.com). ## Which API version to use Bayarcash has two API versions: | Version | Status | When to use it | |---|---|---| | v3 | Current | Every new integration. New features (DuitNow QR on your own page, idempotency, payer identity verification, transaction search) are v3 only. | | v2 | Deprecated | Only if you already run on it. It gets no new features. Plan a move to v3. | ## Sandbox and production Build and test in the sandbox first. No real money moves there. The two environments are separate: each has its own merchant dashboard, its own account and its own keys. | Environment | API base URL | Merchant dashboard | |---|---|---| | Sandbox | `https://api.console.bayarcash-sandbox.com/v3` | [console.bayarcash-sandbox.com](https://console.bayarcash-sandbox.com) | | Production | `https://api.console.bayar.cash/v3` | [console.bayar.cash](https://console.bayar.cash) | When you go live, change the base URL and swap in your production keys. Keys from one environment never work in the other. To test in the sandbox: 1. Sign in to the [sandbox merchant dashboard](https://console.bayarcash-sandbox.com) and copy its Personal Access Token, Portal Key and API Secret Key. See [Find your API keys](/api-keys/). 2. Send your requests to the sandbox base URL. In an SDK, call the sandbox option, for example `useSandbox()` (see [Choose a Bayarcash SDK](/sdks/)). In a plugin, tick its sandbox setting, for example **Sandbox Mode** in [WooCommerce](/woocommerce/#test-in-sandbox). 3. Create a payment and pay it. No real money moves. 4. When it works, change to the production base URL and your production keys. For a quick test, use the shared sandbox account. Its login page shows it: - **Email:** `sandbox@bayarcash.com` - **Password:** `sandbox@bayarcash.com` Other developers use the same account, and Bayarcash resets all its data every day at 12:00 midnight. For your own sandbox account, choose **Register** on the [sandbox login page](https://console.bayarcash-sandbox.com/login). ## What you need Every v3 integration uses these from your merchant dashboard: | Item | What it does | |---|---| | Personal Access Token (PAT) | Proves who you are on every API request. | | Portal key | Says which of your portals receives the payment. | | API Secret Key | Signs requests and verifies callbacks with a checksum. Never sent on its own. | Keep the token and the secret key on your server only. Never put them in a mobile app, browser JavaScript or a public repository. ## Authenticate every request Send your Personal Access Token as a bearer token in the `Authorization` header of every request: ```http Authorization: Bearer Accept: application/json ``` For example, to check that your token works, list your portals in the sandbox: ```bash curl https://api.console.bayarcash-sandbox.com/v3/portals \ -H "Authorization: Bearer $BAYARCASH_PAT" \ -H "Accept: application/json" ``` ## How a payment works A typical payment through the API goes like this: 1. Your server creates a **payment intent** with the portal key, order number, amount, payer name and email, and your `callback_url` and `return_url`. 2. Bayarcash answers with a `url`. Redirect your customer there to pay. 3. When the payment reaches a final state, Bayarcash sends a **callback** to your `callback_url`, server to server. Verify its checksum and update the order. 4. Bayarcash sends the customer back to your `return_url` to show them the result. The callback is the one to trust. See [Verify callbacks and checksums](/callbacks-and-checksum/). ## API errors The API answers with an HTTP status code. These are the codes in the [API reference](https://api-reference.bayarcash.com): | Code | What it means | What to do | |---|---|---| | 403 | The request is not allowed for this item, for example a payment intent that is already paid or a channel that cannot do this action | Check the status of the item first. Read the `message` in the response | | 404 | The item was not found | Check the ID, and check that you use the same environment (sandbox or production) as the item | | 409 | A request with the same `Idempotency-Key` is still in progress | Wait, then send the request again | | 422 | A field is not valid, the item is in the wrong state, or the same `Idempotency-Key` was used with different fields | Read the `errors` in the response and correct the request | | 429 | Too many requests | Wait for the time in the `Retry-After` header, then send again | | 500 | Bayarcash could not process the request ("Error processing request.") | See below | If you get **HTTP 500**: 1. Do not create the payment again straight away. First check if the first request made a payment intent or a transaction. 2. If the first request had an `Idempotency-Key`, send it again with the same key. Bayarcash then does not create a second payment. 3. If the error continues, contact Bayarcash. Give the endpoint, the time of the request and the response body. Never send your Personal Access Token or API Secret Key. ## Tips - **Use an SDK if there is one for your language.** It handles the base URL, the bearer token, checksums and callback verification for you. See [Choose a Bayarcash SDK](/sdks/). - **Send an `Idempotency-Key` header when you create a payment intent.** If a request times out, you can send it again with the same key without creating a second payment. Keys expire after 24 hours. - **Store each transaction ID and check it before you act on a callback.** Callbacks can arrive more than once, and this stops you fulfilling the same order twice. ## Common issues ### My token works in production but the sandbox says it is not valid. Why? Sandbox and production issue separate tokens. A production Personal Access Token does not work against the sandbox API, and a sandbox token does not work in production. Get each token from its own merchant dashboard. ### Should I still use API v2? No. API v2 is deprecated and gets no new features. Use v3 for every new integration. Most SDKs still default to v2, so switch them to v3 (see Choose a Bayarcash SDK (/sdks/)). ### Where is the full list of endpoints and fields? In the API reference at api-reference.bayarcash.com (https://api-reference.bayarcash.com). This help centre explains the ideas; the reference has every endpoint, field and response. --- # Dokumentasi API Bayarcash & sandbox > Bayarcash API v3: base URL untuk sandbox dan production, cara menghantar Personal Access Token dengan setiap request, dan maksud ralat API. > > Source: https://docs.bayarcash.com/ms/developers/ Dengan Bayarcash API, laman web atau app anda boleh mencipta bayaran, menyemak transaksi dan mengurus mandate Direct Debit. Guna **API v3** untuk semua integrasi baru. Rujukan penuh ada di [api-reference.bayarcash.com](https://api-reference.bayarcash.com). ## Pilih versi API Bayarcash ada dua versi API: | Versi | Status | Bila perlu digunakan | |---|---|---| | v3 | Terkini | Untuk setiap integrasi baru. Ciri baru (DuitNow QR pada page anda sendiri, idempotency, pengesahan identiti pembayar, carian transaksi) hanya ada dalam v3. | | v2 | Deprecated | Hanya jika sistem anda sudah menggunakannya. v2 tidak menerima ciri baru. Rancang untuk berpindah ke v3. | ## Sandbox & production Bina dan uji integrasi anda dalam sandbox dahulu. Dalam sandbox, tiada transaksi sebenar yang berlaku. Kedua-dua environment ini berasingan: setiap satu ada merchant dashboard, akaun dan keys sendiri. | Environment | Base URL API | Merchant dashboard | |---|---|---| | Sandbox | `https://api.console.bayarcash-sandbox.com/v3` | [console.bayarcash-sandbox.com](https://console.bayarcash-sandbox.com) | | Production | `https://api.console.bayar.cash/v3` | [console.bayar.cash](https://console.bayar.cash) | Apabila anda go live, tukar base URL dan guna keys production anda. Keys dari satu environment tidak akan berfungsi dalam environment yang lain. Untuk menguji dalam sandbox: 1. Log masuk ke [merchant dashboard sandbox](https://console.bayarcash-sandbox.com), kemudian copy Personal Access Token, Portal Key dan API Secret Key-nya. Lihat [Cari API keys anda](/ms/api-keys/). 2. Hantar request anda ke base URL sandbox. Dalam SDK, guna pilihan sandbox, contohnya `useSandbox()` (lihat [Pilih SDK Bayarcash](/ms/sdks/)). Dalam plugin, tandakan tetapan sandbox-nya, contohnya **Sandbox Mode** dalam [WooCommerce](/ms/woocommerce/#uji-dalam-sandbox). 3. Buat satu bayaran, kemudian bayar. Tiada transaksi sebenar yang berlaku. 4. Apabila semuanya berfungsi, tukar kepada base URL production dan keys production anda. Untuk ujian cepat, anda boleh guna akaun sandbox yang terbuka kepada semua developer. Page log masuk sandbox memaparkan butirannya: - **Email:** `sandbox@bayarcash.com` - **Password:** `sandbox@bayarcash.com` Developer lain juga menggunakan akaun ini. Bayarcash reset semua data dalam akaun itu setiap hari pada 12:00 AM (tengah malam). Untuk membuat akaun sandbox sendiri, klik **Register** pada [page log masuk sandbox](https://console.bayarcash-sandbox.com/login). ## Apa yang anda perlukan Setiap integrasi v3 menggunakan item ini dari merchant dashboard anda: | Item | Fungsinya | |---|---| | Personal Access Token (PAT) | Membuktikan identiti anda pada setiap request API. | | Portal key | Menentukan portal mana yang menerima bayaran. | | API Secret Key | Menandatangani request dan mengesahkan callback dengan checksum. Key ini tidak pernah dihantar dengan sendirinya. | Simpan token dan secret key di server anda sahaja. Jangan letak keys itu dalam aplikasi mudah alih, JavaScript dalam browser atau repository awam. ## Tambah token pada setiap request Hantar Personal Access Token anda sebagai bearer token dalam header `Authorization` bagi setiap request: ```http Authorization: Bearer Accept: application/json ``` Contohnya, untuk menyemak sama ada token anda berfungsi, senaraikan portal anda dalam sandbox: ```bash curl https://api.console.bayarcash-sandbox.com/v3/portals \ -H "Authorization: Bearer $BAYARCASH_PAT" \ -H "Accept: application/json" ``` ## Aliran bayaran melalui API Biasanya, bayaran melalui API berjalan begini: 1. Server anda mencipta **payment intent** dengan portal key, nombor pesanan, amaun, nama dan e-mel pelanggan, serta `callback_url` dan `return_url` anda. 2. Bayarcash membalas dengan `url`. Redirect pelanggan anda ke URL itu untuk membayar. 3. Apabila bayaran mencapai status akhir, Bayarcash menghantar **callback** ke `callback_url` anda, terus dari server ke server. Sahkan checksum-nya dan kemas kini pesanan itu. 4. Bayarcash menghantar pelanggan kembali ke `return_url` anda supaya pelanggan dapat melihat keputusannya. Hanya callback yang boleh anda percayai untuk status bayaran. Lihat [Sahkan callback dan checksum](/ms/callbacks-and-checksum/). ## Ralat API API membalas dengan kod status HTTP. Jadual ini menyenaraikan kod dalam [rujukan API](https://api-reference.bayarcash.com): | Kod | Maksud | Apa yang perlu dibuat | |---|---|---| | 403 | Request itu tidak dibenarkan untuk item ini, contohnya payment intent yang sudah dibayar atau saluran yang tidak boleh membuat tindakan ini | Semak status item itu dahulu. Baca `message` dalam response | | 404 | Item itu tidak dijumpai | Semak ID itu, dan pastikan anda guna environment yang sama dengan item itu (sandbox atau production) | | 409 | Request dengan `Idempotency-Key` yang sama masih diproses | Tunggu, kemudian hantar request itu semula | | 422 | Satu field tidak sah, item itu dalam status yang salah, atau `Idempotency-Key` yang sama digunakan dengan field yang berbeza | Baca `errors` dalam response, kemudian betulkan request itu | | 429 | Terlalu banyak request | Tunggu mengikut masa dalam header `Retry-After`, kemudian hantar semula | | 500 | Bayarcash tidak dapat memproses request itu ("Error processing request.") | Lihat di bawah | Jika anda dapat **HTTP 500**: 1. Jangan terus mencipta bayaran itu semula. Semak dahulu sama ada request pertama sudah mencipta payment intent atau transaksi. 2. Jika request pertama ada `Idempotency-Key`, hantar request itu semula dengan key yang sama. Dengan cara ini, Bayarcash tidak akan mencipta bayaran kedua. 3. Jika ralat itu masih berlaku, hubungi team Bayarcash. Berikan endpoint, masa request dan response body. Jangan hantar Personal Access Token atau API Secret Key anda. ## Tips - **Guna SDK jika ada SDK untuk bahasa pengaturcaraan anda.** SDK menguruskan base URL, bearer token, checksum dan pengesahan callback untuk anda. Lihat [Pilih SDK Bayarcash](/ms/sdks/). - **Hantar header `Idempotency-Key` apabila anda mencipta payment intent.** Jika request timeout, anda boleh menghantar request itu semula dengan key yang sama. Bayarcash tidak akan mencipta bayaran kedua. Key ini tamat tempoh selepas 24 jam. - **Simpan setiap ID transaksi dan semak ID itu sebelum anda bertindak atas callback.** Callback yang sama boleh sampai lebih daripada sekali. Semakan ini memastikan anda tidak memproses pesanan yang sama dua kali. ## Isu biasa ### Kenapa token saya berfungsi dalam production tetapi tidak sah dalam sandbox? Sandbox dan production mengeluarkan token yang berasingan. Personal Access Token production tidak berfungsi dengan API sandbox, dan token sandbox tidak berfungsi dalam production. Dapatkan setiap token dari merchant dashboard environment itu. ### Boleh saya terus guna API v2? Tidak. API v2 sudah deprecated dan tidak akan menerima ciri baru. Guna v3 untuk setiap integrasi baru. Kebanyakan SDK masih bermula pada v2 secara default, jadi tukar SDK itu kepada v3 (lihat Pilih SDK Bayarcash (/ms/sdks/)). ### Di mana saya boleh dapatkan senarai penuh endpoint dan field? Dalam rujukan API di api-reference.bayarcash.com (https://api-reference.bayarcash.com). Panduan dalam Bayarcash Help ini menerangkan konsepnya. Rujukan API pula menyenaraikan setiap endpoint, field dan response. --- # Bayarcash API文档和sandbox > Bayarcash API v3入门:sandbox和正式环境的base URL、怎样在request附上PAT,以及API错误的意思。 > > Source: https://docs.bayarcash.com/zh/developers/ Bayarcash API让你自己的网站或App创建付款、查询交易,以及管理Direct Debit的授权(mandate)。所有新的开发都请使用**API v3**。完整的参考文档在[api-reference.bayarcash.com](https://api-reference.bayarcash.com)。 ## 使用哪个API版本 Bayarcash有两个API版本: | 版本 | 状态 | 什么时候使用 | |---|---|---| | v3 | 当前版本 | 所有新的集成。新功能(在你自己的页面上使用DuitNow QR、idempotency、付款人身份验证、交易搜索)只有v3才有。 | | v2 | 已停用(deprecated) | 只在你已经在用它时使用。它不会再有新功能。请计划迁移到v3。 | ## Sandbox和正式环境 先在sandbox开发和测试。在sandbox里不会产生真实交易。这两个环境是分开的:每个环境都有自己的商家后台(merchant dashboard)、自己的账号和自己的key。 | 环境 | API base URL | 商家后台 | |---|---|---| | Sandbox | `https://api.console.bayarcash-sandbox.com/v3` | [console.bayarcash-sandbox.com](https://console.bayarcash-sandbox.com) | | 正式环境(production) | `https://api.console.bayar.cash/v3` | [console.bayar.cash](https://console.bayar.cash) | 正式上线时,把base URL改为正式环境的,并换上你的正式key。一个环境的key永远不能在另一个环境使用。 要在sandbox测试: 1. 登录[sandbox商家后台](https://console.bayarcash-sandbox.com),复制它的Personal Access Token、Portal Key和API Secret Key。见[找到你的API key](/zh/api-keys/)。 2. 把你的request发送到sandbox base URL。在SDK中,调用sandbox选项,例如`useSandbox()`(见[选择Bayarcash SDK](/zh/sdks/))。在插件中,勾选它的sandbox设置,例如[WooCommerce](/zh/woocommerce/#在sandbox测试)中的**Sandbox Mode**。 3. 创建一笔付款,然后付款。不会产生真实交易。 4. 测试成功后,改用正式环境的base URL和你的正式key。 如果只想快速测试,可以使用共享的sandbox账号。它的登录页面上就有显示: - **Email:** `sandbox@bayarcash.com` - **Password:** `sandbox@bayarcash.com` 其他开发者也使用同一个账号,而且Bayarcash每天午夜12:00会重设这个账号的所有资料。如果要自己的sandbox账号,请在[sandbox登录页面](https://console.bayarcash-sandbox.com/login)选择**Register**。 ## 你需要什么 每个v3集成都会用到商家后台里的这些项目: | 项目 | 作用 | |---|---| | Personal Access Token(PAT) | 在每个API request中证明你的身份。 | | Portal key | 指定由你的哪个portal接收付款。 | | API Secret Key | 用checksum签署request和验证callback。它本身从不单独发送。 | token和secret key只能保存在你的服务器上。绝对不要把它们放在手机App、浏览器JavaScript或公开的repository里。 ## 为每个request进行身份验证 在每个request的`Authorization` header中,把你的Personal Access Token作为bearer token发送: ```http Authorization: Bearer Accept: application/json ``` 例如,要检查你的token是否有效,可以在sandbox列出你的portal: ```bash curl https://api.console.bayarcash-sandbox.com/v3/portals \ -H "Authorization: Bearer $BAYARCASH_PAT" \ -H "Accept: application/json" ``` ## 付款怎样进行 通过API的一般付款流程如下: 1. 你的服务器用portal key、订单号码、金额、付款人姓名和电邮,以及你的`callback_url`和`return_url`,创建一个**payment intent**。 2. Bayarcash回复一个`url`。把你的顾客重定向到那里付款。 3. 付款到达最终状态时,Bayarcash会从服务器到服务器,向你的`callback_url`发送**callback**。验证它的checksum,然后更新订单。 4. Bayarcash把顾客送回你的`return_url`,向他们显示结果。 应该信任的是callback。见[验证callback和checksum](/zh/callbacks-and-checksum/)。 ## API错误 API会以HTTP状态码回复。以下是[API参考文档](https://api-reference.bayarcash.com)中的状态码: | 状态码 | 意思 | 怎么做 | |---|---|---| | 403 | 这个项目不允许这个request,例如已付款的payment intent,或无法执行这个操作的渠道 | 先检查这个项目的状态。阅读response中的`message` | | 404 | 找不到这个项目 | 检查ID,并确认你使用的环境(sandbox或正式环境)和这个项目相同 | | 409 | 使用相同`Idempotency-Key`的request仍在处理中 | 稍等,然后再发送一次request | | 422 | 某个field无效、项目状态不对,或同一个`Idempotency-Key`被用于不同的field | 阅读response中的`errors`,然后修正request | | 429 | request太多 | 等待`Retry-After` header中的时间,然后再发送 | | 500 | Bayarcash无法处理这个request(“Error processing request.”) | 见下文 | 如果你收到**HTTP 500**: 1. 不要马上再创建付款。先检查第一个request是否已经创建了payment intent或交易。 2. 如果第一个request带有`Idempotency-Key`,就用同一个key再发送一次。这样Bayarcash不会创建第二笔付款。 3. 如果错误持续,请联系Bayarcash。提供endpoint、request的时间和response body。绝对不要发送你的Personal Access Token或API Secret Key。 ## 小贴士 - **如果你的编程语言有SDK,就使用SDK**。它会替你处理base URL、bearer token、checksum和callback验证。见[选择Bayarcash SDK](/zh/sdks/)。 - **创建payment intent时,发送`Idempotency-Key` header**。如果request超时,你可以用同一个key再发送一次,不会创建第二笔付款。key在24小时后过期。 - **保存每个交易ID,并在根据callback处理订单前先检查它**。同一个callback可能不止到达一次,这样可以避免同一个订单被处理两次。 ## 常见问题 ### 我的token在正式环境可以用,但sandbox说它无效。为什么? Sandbox和正式环境各自发出不同的token。正式环境的Personal Access Token不能用在sandbox API,sandbox的token也不能用在正式环境。请从各自的商家后台获取每个token。 ### 我还应该用API v2吗? 不用。API v2已停用(deprecated),不会再有新功能。所有新的集成都请用v3。大多数SDK默认仍是v2,所以请把它们切换到v3(见选择Bayarcash SDK (/zh/sdks/))。 ### 哪里可以找到完整的endpoint和field列表? 在API参考文档api-reference.bayarcash.com (https://api-reference.bayarcash.com)。这个Help Centre解释概念,参考文档则列出每个endpoint、field和response。 --- # Choose a Bayarcash SDK > Official Bayarcash libraries for PHP, Node.js, Python, Go, .NET, Dart, Ruby and Rust, plus Laravel and Django packages, with install commands. > > Source: https://docs.bayarcash.com/sdks/ Bayarcash publishes official SDKs for eight languages and packages for Laravel and Django. Each one handles the base URL, your Personal Access Token, request checksums and callback verification, so you write less code. All of them are open source at [github.com/bayarcash](https://github.com/bayarcash). ## Language SDKs Install the SDK for your language with its package manager: | Language | Package | Install | Needs | Source | |---|---|---|---|---| | PHP | `bayarcash/php-sdk` | `composer require bayarcash/php-sdk` | PHP 7.4 or newer | [php-sdk](https://github.com/bayarcash/php-sdk) | | Node.js and TypeScript | `bayarcash` | `npm install bayarcash` | Node.js 18 or newer | [node-sdk](https://github.com/bayarcash/node-sdk) | | Python | `bayarcash` | `pip install bayarcash` | Python 3.8 or newer | [python-sdk](https://github.com/bayarcash/python-sdk) | | Go | `github.com/bayarcash/go-sdk` | `go get github.com/bayarcash/go-sdk` | Go 1.21 or newer | [go-sdk](https://github.com/bayarcash/go-sdk) | | C# and .NET | `Bayarcash` | `dotnet add package Bayarcash` | .NET Standard 2.0 or newer | [dotnet-sdk](https://github.com/bayarcash/dotnet-sdk) | | Dart and Flutter | `bayarcash` | `dart pub add bayarcash` | Dart 2.17 or newer | [dart-sdk](https://github.com/bayarcash/dart-sdk) | | Ruby | `bayarcash` | `gem install bayarcash` | Ruby 2.7 or newer | [ruby-sdk](https://github.com/bayarcash/ruby-sdk) | | Rust | `bayarcash` | `cargo add bayarcash` | Rust 1.75 or newer | [rust-sdk](https://github.com/bayarcash/rust-sdk) | Minimum versions are as at the time of writing. Each repository's README has the current requirements, a full guide and examples. ## Framework packages If your app runs on Laravel or Django, use the framework package instead of the plain SDK. It adds configuration, ready-made callback and return routes that verify the checksum for you, optional database records and scheduled reconciliation. | Framework | Package | Install | Needs | Source | |---|---|---|---|---| | Laravel | `bayarcash/laravel` | `composer require bayarcash/laravel` | PHP 8.1 or newer, Laravel 10 to 12 | [laravel](https://github.com/bayarcash/laravel) | | Django | `django-bayarcash` | `pip install django-bayarcash` | Python 3.8 or newer, Django 3.2 to 5 | [django](https://github.com/bayarcash/django) | Both packages always use API v3. ## Switch the SDK to API v3 The language SDKs support API v2 and v3, and start on **v2**. API v2 is deprecated, so switch to v3 as soon as you create the client. Some methods, such as searching transactions, only work on v3. | SDK | Switch to v3 | Use the sandbox | |---|---|---| | PHP | `$bayarcash->setApiVersion('v3')` | `$bayarcash->useSandbox()` | | Node.js | `bayarcash.setApiVersion('v3')` | `bayarcash.useSandbox()` | | Python | `bayarcash.set_api_version("v3")` | `bayarcash.use_sandbox()` | | Go | `bayarcash.WithAPIVersion("v3")` option | `bayarcash.WithSandbox(true)` option | | .NET | `bayarcash.SetApiVersion("v3")` | `bayarcash.UseSandbox()` | | Dart | `bayarcash.setApiVersion('v3')` | `bayarcash.useSandbox()` | | Ruby | `bayarcash.set_api_version("v3")` | `bayarcash.use_sandbox` | | Rust | `.set_api_version(ApiVersion::V3)` | `.use_sandbox()` | Remove the sandbox call in production. For a full walkthrough in PHP, see [Accept payments with the PHP SDK](/php-sdk/). ## No-code option To use Bayarcash in automated workflows without writing code, see [Use Bayarcash in n8n](/n8n/). ## Tips - **Keep your token and secret key in environment variables.** Every SDK README uses placeholders such as `YOUR_API_TOKEN`; never commit real keys to your repository. - **Pin the SDK version in your project.** Your package manager's lock file stops an update from changing behaviour between deploys. Read the SDK's changelog before you upgrade. ## Common issues ### I installed the SDK but a method says it is only available for API version v3. Why? Most SDKs start on API v2. Switch the client to v3 before you make any request, for example setApiVersion('v3') in PHP. The Laravel and Django packages are already set to v3. ### Which SDK should I pick if my language is not listed? Call the REST API directly. Send your Personal Access Token as a bearer token and follow api-reference.bayarcash.com (https://api-reference.bayarcash.com). See Build on the Bayarcash API (/developers/). --- # Pilih SDK Bayarcash > Library rasmi Bayarcash untuk PHP, Node.js, Python, Go, .NET, Dart, Ruby dan Rust, serta pakej Laravel dan Django, dengan arahan install. > > Source: https://docs.bayarcash.com/ms/sdks/ Bayarcash menerbitkan SDK rasmi untuk lapan bahasa pengaturcaraan, serta pakej untuk Laravel dan Django. Setiap SDK menguruskan base URL, Personal Access Token anda, checksum request dan pengesahan callback. Jadi, anda perlu menulis lebih sedikit kod. Semua SDK ini open source di [github.com/bayarcash](https://github.com/bayarcash). ## SDK mengikut bahasa Install SDK untuk bahasa anda dengan package manager bahasa itu: | Bahasa | Pakej | Install | Keperluan | Sumber | |---|---|---|---|---| | PHP | `bayarcash/php-sdk` | `composer require bayarcash/php-sdk` | PHP 7.4 atau lebih baru | [php-sdk](https://github.com/bayarcash/php-sdk) | | Node.js dan TypeScript | `bayarcash` | `npm install bayarcash` | Node.js 18 atau lebih baru | [node-sdk](https://github.com/bayarcash/node-sdk) | | Python | `bayarcash` | `pip install bayarcash` | Python 3.8 atau lebih baru | [python-sdk](https://github.com/bayarcash/python-sdk) | | Go | `github.com/bayarcash/go-sdk` | `go get github.com/bayarcash/go-sdk` | Go 1.21 atau lebih baru | [go-sdk](https://github.com/bayarcash/go-sdk) | | C# dan .NET | `Bayarcash` | `dotnet add package Bayarcash` | .NET Standard 2.0 atau lebih baru | [dotnet-sdk](https://github.com/bayarcash/dotnet-sdk) | | Dart dan Flutter | `bayarcash` | `dart pub add bayarcash` | Dart 2.17 atau lebih baru | [dart-sdk](https://github.com/bayarcash/dart-sdk) | | Ruby | `bayarcash` | `gem install bayarcash` | Ruby 2.7 atau lebih baru | [ruby-sdk](https://github.com/bayarcash/ruby-sdk) | | Rust | `bayarcash` | `cargo add bayarcash` | Rust 1.75 atau lebih baru | [rust-sdk](https://github.com/bayarcash/rust-sdk) | Versi minimum ini betul semasa panduan ini ditulis. README setiap repository ada keperluan terkini, panduan penuh dan contoh. ## Pakej framework Jika app anda menggunakan Laravel atau Django, guna pakej framework dan bukan SDK biasa. Pakej ini menambah konfigurasi, serta route callback dan return yang sudah siap dan mengesahkan checksum untuk anda. Pakej ini juga menyediakan rekod database (jika perlu) dan reconciliation berjadual. | Framework | Pakej | Install | Keperluan | Sumber | |---|---|---|---|---| | Laravel | `bayarcash/laravel` | `composer require bayarcash/laravel` | PHP 8.1 atau lebih baru, Laravel 10 hingga 12 | [laravel](https://github.com/bayarcash/laravel) | | Django | `django-bayarcash` | `pip install django-bayarcash` | Python 3.8 atau lebih baru, Django 3.2 hingga 5 | [django](https://github.com/bayarcash/django) | Kedua-dua pakej sentiasa menggunakan API v3. ## Tukar SDK kepada API v3 SDK bahasa menyokong API v2 dan v3, dan bermula pada **v2**. API v2 sudah deprecated, jadi tukar kepada v3 sebaik sahaja anda mencipta client. Sesetengah method, seperti carian transaksi, hanya berfungsi pada v3. | SDK | Tukar kepada v3 | Guna sandbox | |---|---|---| | PHP | `$bayarcash->setApiVersion('v3')` | `$bayarcash->useSandbox()` | | Node.js | `bayarcash.setApiVersion('v3')` | `bayarcash.useSandbox()` | | Python | `bayarcash.set_api_version("v3")` | `bayarcash.use_sandbox()` | | Go | option `bayarcash.WithAPIVersion("v3")` | option `bayarcash.WithSandbox(true)` | | .NET | `bayarcash.SetApiVersion("v3")` | `bayarcash.UseSandbox()` | | Dart | `bayarcash.setApiVersion('v3')` | `bayarcash.useSandbox()` | | Ruby | `bayarcash.set_api_version("v3")` | `bayarcash.use_sandbox` | | Rust | `.set_api_version(ApiVersion::V3)` | `.use_sandbox()` | Buang panggilan sandbox dalam production. Untuk panduan penuh dalam PHP, lihat [Terima bayaran dengan PHP SDK](/ms/php-sdk/). ## Pilihan tanpa kod Untuk menggunakan Bayarcash dalam workflow automatik tanpa menulis kod, lihat [Guna Bayarcash dalam n8n](/ms/n8n/). ## Tips - **Simpan token dan secret key anda dalam environment variable.** Setiap README SDK menggunakan placeholder seperti `YOUR_API_TOKEN`. Jangan commit keys sebenar ke repository anda. - **Pin versi SDK dalam projek anda.** Lock file package manager anda menghalang update daripada mengubah tingkah laku SDK antara deploy. Baca changelog SDK itu sebelum anda upgrade. ## Isu biasa ### Kenapa SDK kata method itu hanya ada untuk API versi v3, walaupun saya sudah install SDK? Kebanyakan SDK bermula pada API v2. Tukar client kepada v3 sebelum anda membuat sebarang request, contohnya setApiVersion('v3') dalam PHP. Pakej Laravel dan Django sudah ditetapkan kepada v3. ### SDK mana yang perlu saya pilih jika bahasa pengaturcaraan saya tiada dalam senarai? Panggil REST API secara terus. Hantar Personal Access Token anda sebagai bearer token dan ikut api-reference.bayarcash.com (https://api-reference.bayarcash.com). Lihat Bina integrasi dengan Bayarcash API (/ms/developers/). --- # 选择Bayarcash SDK > 官方PHP、Node.js、Python、Go、.NET、Dart、Ruby和Rust库,以及Laravel和Django package和安装命令。 > > Source: https://docs.bayarcash.com/zh/sdks/ Bayarcash为八种编程语言发布了官方SDK,也为Laravel和Django提供package。每一个都会处理base URL、你的Personal Access Token、request checksum和callback验证,让你少写代码。它们全部开源,放在[github.com/bayarcash](https://github.com/bayarcash)。 ## 各编程语言的SDK 用你的编程语言的package manager安装对应的SDK: | 编程语言 | Package | 安装 | 要求 | 源代码 | |---|---|---|---|---| | PHP | `bayarcash/php-sdk` | `composer require bayarcash/php-sdk` | PHP 7.4或更新版本 | [php-sdk](https://github.com/bayarcash/php-sdk) | | Node.js和TypeScript | `bayarcash` | `npm install bayarcash` | Node.js 18或更新版本 | [node-sdk](https://github.com/bayarcash/node-sdk) | | Python | `bayarcash` | `pip install bayarcash` | Python 3.8或更新版本 | [python-sdk](https://github.com/bayarcash/python-sdk) | | Go | `github.com/bayarcash/go-sdk` | `go get github.com/bayarcash/go-sdk` | Go 1.21或更新版本 | [go-sdk](https://github.com/bayarcash/go-sdk) | | C#和.NET | `Bayarcash` | `dotnet add package Bayarcash` | .NET Standard 2.0或更新版本 | [dotnet-sdk](https://github.com/bayarcash/dotnet-sdk) | | Dart和Flutter | `bayarcash` | `dart pub add bayarcash` | Dart 2.17或更新版本 | [dart-sdk](https://github.com/bayarcash/dart-sdk) | | Ruby | `bayarcash` | `gem install bayarcash` | Ruby 2.7或更新版本 | [ruby-sdk](https://github.com/bayarcash/ruby-sdk) | | Rust | `bayarcash` | `cargo add bayarcash` | Rust 1.75或更新版本 | [rust-sdk](https://github.com/bayarcash/rust-sdk) | 最低版本以撰写时为准。每个repository的README都有最新的要求、完整指南和示例。 ## 框架package 如果你的App在Laravel或Django上运行,请使用框架package,而不是普通的SDK。它会加入配置、现成的callback和return route(替你验证checksum)、可选的数据库记录,以及定时对账。 | 框架 | Package | 安装 | 要求 | 源代码 | |---|---|---|---|---| | Laravel | `bayarcash/laravel` | `composer require bayarcash/laravel` | PHP 8.1或更新版本,Laravel 10至12 | [laravel](https://github.com/bayarcash/laravel) | | Django | `django-bayarcash` | `pip install django-bayarcash` | Python 3.8或更新版本,Django 3.2至5 | [django](https://github.com/bayarcash/django) | 这两个package都一直使用API v3。 ## 把SDK切换到API v3 各编程语言的SDK支持API v2和v3,并从**v2**开始。API v2已停用(deprecated),所以创建client后要马上切换到v3。有些method,例如搜索交易,只能在v3使用。 | SDK | 切换到v3 | 使用sandbox | |---|---|---| | PHP | `$bayarcash->setApiVersion('v3')` | `$bayarcash->useSandbox()` | | Node.js | `bayarcash.setApiVersion('v3')` | `bayarcash.useSandbox()` | | Python | `bayarcash.set_api_version("v3")` | `bayarcash.use_sandbox()` | | Go | `bayarcash.WithAPIVersion("v3")`选项 | `bayarcash.WithSandbox(true)`选项 | | .NET | `bayarcash.SetApiVersion("v3")` | `bayarcash.UseSandbox()` | | Dart | `bayarcash.setApiVersion('v3')` | `bayarcash.useSandbox()` | | Ruby | `bayarcash.set_api_version("v3")` | `bayarcash.use_sandbox` | | Rust | `.set_api_version(ApiVersion::V3)` | `.use_sandbox()` | 在正式环境(production)中删除sandbox调用。PHP的完整指南,见[使用PHP SDK收款](/zh/php-sdk/)。 ## 无代码选项 如果要在自动化工作流程中使用Bayarcash而不写代码,见[在n8n中使用Bayarcash](/zh/n8n/)。 ## 小贴士 - **把token和secret key放在环境变量中**。每个SDK的README都使用`YOUR_API_TOKEN`之类的占位符。绝对不要把真实的key提交(commit)到你的repository。 - **在项目中固定SDK的版本**。package manager的lock file能防止更新在两次部署之间改变运行方式。升级前先阅读SDK的changelog。 ## 常见问题 ### 我安装了SDK,但某个method说它只适用于API版本v3。为什么? 大多数SDK一开始使用API v2。在发出任何request之前,先把client切换到v3,例如PHP中的setApiVersion('v3')。Laravel和Django package已经设为v3。 ### 如果列表中没有我用的编程语言,应该选哪个SDK? 直接调用REST API。把你的Personal Access Token作为bearer token发送,并按照api-reference.bayarcash.com (https://api-reference.bayarcash.com)操作。见用Bayarcash API开发 (/zh/developers/)。 --- # Accept payments with the PHP SDK > Install the Bayarcash PHP SDK, create a payment on API v3, verify the callback and look up transactions from your own PHP site. > > Source: https://docs.bayarcash.com/php-sdk/ The Bayarcash PHP SDK lets your PHP site create payments, verify callbacks and look up transactions without writing the HTTP calls yourself. This guide uses API v3, the current version. The SDK's [README on GitHub](https://github.com/bayarcash/php-sdk) has every method. On Laravel, use the [Laravel package](https://github.com/bayarcash/laravel) instead: it wraps this SDK and adds routes and configuration. See [Choose a Bayarcash SDK](/sdks/). ## Before you start You need: - PHP 7.4 or newer with the `json` extension, and Composer. - Your Personal Access Token (PAT), API Secret Key and a portal key from the merchant dashboard. Use sandbox keys while you build. ## Install the SDK Run this in your project folder: ```bash composer require bayarcash/php-sdk ``` The package used to be called `webimpian/bayarcash-php-sdk`. Old installations still work, but use `bayarcash/php-sdk` for anything new. ## Create the client Create one client with your token, then switch it to API v3. The SDK starts on v2, which is deprecated. ```php use Bayarcash\Bayarcash; $bayarcash = new Bayarcash(getenv('BAYARCASH_PAT')); $bayarcash->setApiVersion('v3'); $bayarcash->useSandbox(); // remove this line in production $apiSecretKey = getenv('BAYARCASH_API_SECRET_KEY'); ``` Call `setApiVersion()` and `useSandbox()` before you make any request. ## Take a payment To take a payment, build the request, sign it, and send your customer to the payment page: 1. Build the request with your portal key, order details and URLs. 2. Add a checksum signed with your API Secret Key. 3. Create the payment intent and redirect the customer to its `url`. ```php $data = [ 'portal_key' => 'your_portal_key', 'payment_channel' => Bayarcash::FPX, 'order_number' => 'INV-1001', 'amount' => '10.00', 'payer_name' => 'Ahmad bin Abdullah', 'payer_email' => 'ahmad@example.com', 'payer_telephone_number' => '0123456789', 'return_url' => 'https://your-site.com/payment/return', 'callback_url' => 'https://your-site.com/payment/callback', ]; $data['checksum'] = $bayarcash->createPaymentIntentChecksumValue($apiSecretKey, $data); $paymentIntent = $bayarcash->createPaymentIntent($data); header('Location: ' . $paymentIntent->url); exit; ``` The main request fields are: | Field | Required | Notes | |---|---|---| | `portal_key` | Yes | The portal that receives the payment. | | `order_number` | Yes | Your reference, up to 30 characters. | | `amount` | Yes | A string with up to 2 decimals, such as `'10.00'`. | | `payer_name`, `payer_email` | Yes | The customer's name and email. | | `payment_channel` | No | One `Bayarcash::*` constant or an array of them. Leave it out to let the customer choose. | | `payer_telephone_number` | No | Needed for e-wallet and DuitNow channels. | | `callback_url`, `return_url` | No | Where Bayarcash notifies your server, and where it sends the customer back. | The checksum is built from `payment_channel`, `order_number`, `amount`, `payer_name` and `payer_email`, so add it after those fields are final. To retry a timed-out request safely, pass a UUID as a second argument: `createPaymentIntent($data, $idempotencyKey)`. ## Verify the callback Bayarcash posts the result to your `callback_url` when the payment reaches a final state. Verify it before you update the order: ```php use Bayarcash\Fpx; $callbackData = $_POST; if (! $bayarcash->verifyTransactionCallbackData($callbackData, $apiSecretKey)) { http_response_code(403); exit; } if ((int) $callbackData['status'] === Fpx::STATUS_SUCCESS) { // Mark the order with $callbackData['order_number'] as paid. } http_response_code(200); ``` Use `verifyReturnUrlCallbackData()` on your `return_url` page. On v3 the customer comes back with the fields in the query string, so pass `$_GET`. Show the result to the customer, but update the order from the callback only. See [Verify callbacks and checksums](/callbacks-and-checksum/) for why. ## Look up payments and transactions These calls read what Bayarcash has recorded: ```php $intent = $bayarcash->getPaymentIntent('payment_intent_id'); $transaction = $bayarcash->getTransaction('transaction_id'); $byOrder = $bayarcash->getTransactionByOrderNumber('INV-1001'); $result = $bayarcash->getAllTransactions([ 'status' => '3', 'payment_channel' => Bayarcash::FPX, ]); // $result['data'] holds the transactions, $result['meta'] the pagination. ``` To cancel a payment intent the customer has not paid, call `$bayarcash->cancelPaymentIntent('payment_intent_id')`. ## Handle errors Failed calls throw exceptions from `Bayarcash\Exceptions`: | Exception | HTTP status | What to do | |---|---|---| | `ValidationException` | 422 | Fix the request. `$e->errors()` lists the fields. | | `FailedActionException` | 400 | Read `$e->getMessage()` for the reason. | | `NotFoundException` | 404 | Check the ID you asked for. | | `RateLimitExceededException` | 429 | Wait. `$e->rateLimitResetsAt` has the reset time. | ## Tips - **Test the whole flow in the sandbox first.** Create a payment, pay it, and check that your callback marks the order paid before you switch to production keys. - **Keep the token and API Secret Key out of your code.** Load them from environment variables or your framework's secret store, as in the examples above. - **Use the channel constants instead of numbers.** `Bayarcash::FPX` reads better than `1`, and the README lists every channel constant. ## Common issues ### After updating the SDK I get: Class "Webimpian\BayarcashSdk\Bayarcash" not found. What changed? Version 3 of the SDK renamed its namespace to Bayarcash. Change your imports to use Bayarcash\Bayarcash; (and Bayarcash\Fpx, Bayarcash\FpxDirectDebit). New projects should also install bayarcash/php-sdk instead of the old webimpian/bayarcash-php-sdk package. ### I get "The getTransactionByOrderNumber method is only available for API version v3." Why? The SDK starts on API v2. Call $bayarcash->setApiVersion('v3') right after you create the client, before any request. ### createPaymentIntent throws a ValidationException. How do I see what is wrong? Call $e->errors() on the exception. It lists each field the API rejected, for example an amount outside the allowed range or an order number longer than 30 characters. --- # Terima bayaran dengan PHP SDK > Install PHP SDK Bayarcash, cipta bayaran pada API v3, sahkan callback dan semak transaksi dari laman web PHP anda. > > Source: https://docs.bayarcash.com/ms/php-sdk/ Dengan PHP SDK Bayarcash, laman web PHP anda boleh mencipta bayaran, mengesahkan callback dan menyemak transaksi. Anda tidak perlu menulis HTTP call sendiri. Panduan ini menggunakan API v3, iaitu versi terkini. [README SDK di GitHub](https://github.com/bayarcash/php-sdk) menyenaraikan setiap method. Jika anda menggunakan Laravel, guna [pakej Laravel](https://github.com/bayarcash/laravel). Pakej ini dibina atas SDK ini, dan menambah route serta konfigurasi. Lihat [Pilih SDK Bayarcash](/ms/sdks/). ## Sebelum anda mula Sediakan perkara ini dahulu: - PHP 7.4 atau lebih baru dengan extension `json`, dan Composer. - Personal Access Token (PAT), API Secret Key dan satu portal key dari merchant dashboard. Guna keys sandbox semasa anda membina integrasi. ## Install SDK Jalankan arahan ini dalam folder projek anda: ```bash composer require bayarcash/php-sdk ``` Nama lama pakej ini ialah `webimpian/bayarcash-php-sdk`. Projek yang menggunakan pakej lama masih berfungsi, tetapi guna `bayarcash/php-sdk` untuk projek baru. ## Cipta client Cipta satu client dengan token anda, kemudian tukar client itu kepada API v3. SDK bermula pada v2, dan v2 sudah deprecated. ```php use Bayarcash\Bayarcash; $bayarcash = new Bayarcash(getenv('BAYARCASH_PAT')); $bayarcash->setApiVersion('v3'); $bayarcash->useSandbox(); // remove this line in production $apiSecretKey = getenv('BAYARCASH_API_SECRET_KEY'); ``` Panggil `setApiVersion()` dan `useSandbox()` sebelum anda membuat sebarang request. ## Terima bayaran Untuk menerima bayaran, bina request, tandatangani request itu, dan hantar pelanggan ke page bayaran: 1. Bina request dengan portal key, butiran pesanan dan URL anda. 2. Tambah checksum yang ditandatangani dengan API Secret Key anda. 3. Cipta payment intent dan redirect pelanggan ke `url` payment intent itu. ```php $data = [ 'portal_key' => 'your_portal_key', 'payment_channel' => Bayarcash::FPX, 'order_number' => 'INV-1001', 'amount' => '10.00', 'payer_name' => 'Ahmad bin Abdullah', 'payer_email' => 'ahmad@example.com', 'payer_telephone_number' => '0123456789', 'return_url' => 'https://your-site.com/payment/return', 'callback_url' => 'https://your-site.com/payment/callback', ]; $data['checksum'] = $bayarcash->createPaymentIntentChecksumValue($apiSecretKey, $data); $paymentIntent = $bayarcash->createPaymentIntent($data); header('Location: ' . $paymentIntent->url); exit; ``` Field utama dalam request: | Field | Wajib | Nota | |---|---|---| | `portal_key` | Ya | Portal yang menerima bayaran. | | `order_number` | Ya | Rujukan anda, maksimum 30 aksara. | | `amount` | Ya | String dengan maksimum 2 tempat perpuluhan, contohnya `'10.00'`. | | `payer_name`, `payer_email` | Ya | Nama dan e-mel pelanggan. | | `payment_channel` | Tidak | Satu constant `Bayarcash::*` atau array constant. Jika anda tidak menghantar field ini, pelanggan memilih saluran sendiri. | | `payer_telephone_number` | Tidak | Diperlukan untuk saluran e-wallet dan DuitNow. | | `callback_url`, `return_url` | Tidak | URL untuk Bayarcash memaklumkan server anda, dan URL untuk Bayarcash menghantar pelanggan kembali. | Checksum dibina daripada `payment_channel`, `order_number`, `amount`, `payer_name` dan `payer_email`. Jadi, tambah checksum selepas nilai field itu muktamad. Untuk menghantar semula request yang timeout dengan selamat, hantar UUID sebagai argumen kedua: `createPaymentIntent($data, $idempotencyKey)`. ## Sahkan callback Apabila bayaran mencapai status akhir, Bayarcash menghantar keputusan ke `callback_url` anda sebagai POST. Sahkan callback itu sebelum anda mengemas kini pesanan: ```php use Bayarcash\Fpx; $callbackData = $_POST; if (! $bayarcash->verifyTransactionCallbackData($callbackData, $apiSecretKey)) { http_response_code(403); exit; } if ((int) $callbackData['status'] === Fpx::STATUS_SUCCESS) { // Mark the order with $callbackData['order_number'] as paid. } http_response_code(200); ``` Guna `verifyReturnUrlCallbackData()` pada page `return_url` anda. Pada v3, pelanggan kembali dengan field dalam query string, jadi hantar `$_GET`. Paparkan keputusan kepada pelanggan, tetapi kemas kini pesanan daripada callback sahaja. Sebabnya ada dalam [Sahkan callback dan checksum](/ms/callbacks-and-checksum/). ## Semak bayaran & transaksi Panggilan ini membaca data yang Bayarcash rekodkan: ```php $intent = $bayarcash->getPaymentIntent('payment_intent_id'); $transaction = $bayarcash->getTransaction('transaction_id'); $byOrder = $bayarcash->getTransactionByOrderNumber('INV-1001'); $result = $bayarcash->getAllTransactions([ 'status' => '3', 'payment_channel' => Bayarcash::FPX, ]); // $result['data'] holds the transactions, $result['meta'] the pagination. ``` Untuk membatalkan payment intent yang pelanggan belum bayar, panggil `$bayarcash->cancelPaymentIntent('payment_intent_id')`. ## Urus ralat Jika panggilan gagal, SDK akan throw exception dari `Bayarcash\Exceptions`: | Exception | Status HTTP | Apa yang perlu dibuat | |---|---|---| | `ValidationException` | 422 | Betulkan request. `$e->errors()` menyenaraikan field yang salah. | | `FailedActionException` | 400 | Baca `$e->getMessage()` untuk mengetahui sebabnya. | | `NotFoundException` | 404 | Semak ID yang anda minta. | | `RateLimitExceededException` | 429 | Tunggu. `$e->rateLimitResetsAt` memberikan masa reset. | ## Tips - **Uji keseluruhan aliran dalam sandbox dahulu.** Cipta bayaran dan bayar. Kemudian pastikan callback anda menandakan pesanan itu sebagai sudah dibayar, sebelum anda tukar kepada keys production. - **Jangan letak token dan API Secret Key dalam kod anda.** Ambil keys itu dari environment variable atau secret store framework anda, seperti dalam contoh di atas. - **Guna constant saluran dan bukan nombor.** `Bayarcash::FPX` lebih mudah dibaca berbanding `1`, dan README menyenaraikan setiap constant saluran. ## Isu biasa ### Kenapa saya dapat ralat Class "Webimpian\BayarcashSdk\Bayarcash" not found selepas update SDK? Versi 3 SDK menukar namespace kepada Bayarcash. Tukar import anda kepada use Bayarcash\Bayarcash; (serta Bayarcash\Fpx dan Bayarcash\FpxDirectDebit). Untuk projek baru, install bayarcash/php-sdk. Jangan guna pakej lama webimpian/bayarcash-php-sdk. ### Kenapa saya dapat ralat "The getTransactionByOrderNumber method is only available for API version v3."? SDK bermula pada API v2. Panggil $bayarcash->setApiVersion('v3') sejurus selepas anda mencipta client, sebelum sebarang request. ### Bagaimana saya tahu punca ValidationException daripada createPaymentIntent? Panggil $e->errors() pada exception itu. Method ini menyenaraikan setiap field yang API tolak, contohnya amaun di luar julat yang dibenarkan atau nombor pesanan yang lebih daripada 30 aksara. --- # 使用PHP SDK收款 > 安装Bayarcash PHP SDK,在API v3上创建付款、验证callback,并从你自己的PHP网站查询交易。 > > Source: https://docs.bayarcash.com/zh/php-sdk/ Bayarcash PHP SDK让你的PHP网站创建付款、验证callback和查询交易,不用自己编写HTTP调用。本指南使用当前版本API v3。SDK在[GitHub上的README](https://github.com/bayarcash/php-sdk)列出了每个method。 如果你用Laravel,请改用[Laravel package](https://github.com/bayarcash/laravel):它封装了这个SDK,并加入route和配置。见[选择Bayarcash SDK](/zh/sdks/)。 ## 开始之前 你需要: - PHP 7.4或更新版本(带`json` extension),以及Composer。 - 商家后台(merchant dashboard)中的Personal Access Token(PAT)、API Secret Key和一个portal key。开发期间请使用sandbox key。 ## 安装SDK 在你的项目文件夹中运行: ```bash composer require bayarcash/php-sdk ``` 这个package以前叫`webimpian/bayarcash-php-sdk`。旧的安装仍然可以用,但新的项目请使用`bayarcash/php-sdk`。 ## 创建client 用你的token创建一个client,然后把它切换到API v3。SDK从v2开始,而v2已停用。 ```php use Bayarcash\Bayarcash; $bayarcash = new Bayarcash(getenv('BAYARCASH_PAT')); $bayarcash->setApiVersion('v3'); $bayarcash->useSandbox(); // remove this line in production $apiSecretKey = getenv('BAYARCASH_API_SECRET_KEY'); ``` 在发出任何request之前,先调用`setApiVersion()`和`useSandbox()`。 ## 收款 要收款,先建立request并签署它,然后把你的顾客送到付款页面: 1. 用你的portal key、订单资料和URL建立request。 2. 加上用你的API Secret Key签署的checksum。 3. 创建payment intent,并把顾客重定向到它的`url`。 ```php $data = [ 'portal_key' => 'your_portal_key', 'payment_channel' => Bayarcash::FPX, 'order_number' => 'INV-1001', 'amount' => '10.00', 'payer_name' => 'Ahmad bin Abdullah', 'payer_email' => 'ahmad@example.com', 'payer_telephone_number' => '0123456789', 'return_url' => 'https://your-site.com/payment/return', 'callback_url' => 'https://your-site.com/payment/callback', ]; $data['checksum'] = $bayarcash->createPaymentIntentChecksumValue($apiSecretKey, $data); $paymentIntent = $bayarcash->createPaymentIntent($data); header('Location: ' . $paymentIntent->url); exit; ``` 主要的request field如下: | Field | 必填 | 说明 | |---|---|---| | `portal_key` | 是 | 接收付款的portal。 | | `order_number` | 是 | 你的参考编号,最多30个字符。 | | `amount` | 是 | 最多2位小数的字符串,例如`'10.00'`。 | | `payer_name`, `payer_email` | 是 | 顾客的姓名和电邮。 | | `payment_channel` | 否 | 一个`Bayarcash::*` constant,或由它们组成的array。不填的话,由顾客自己选择。 | | `payer_telephone_number` | 否 | 电子钱包和DuitNow渠道需要。 | | `callback_url`, `return_url` | 否 | Bayarcash通知你服务器的地址,以及把顾客送回的地址。 | checksum由`payment_channel`、`order_number`、`amount`、`payer_name`和`payer_email`生成,所以要在这些field确定后才加上。要安全地重试超时的request,把一个UUID作为第二个参数传入:`createPaymentIntent($data, $idempotencyKey)`。 ## 验证callback 付款到达最终状态时,Bayarcash会把结果POST到你的`callback_url`。更新订单前先验证它: ```php use Bayarcash\Fpx; $callbackData = $_POST; if (! $bayarcash->verifyTransactionCallbackData($callbackData, $apiSecretKey)) { http_response_code(403); exit; } if ((int) $callbackData['status'] === Fpx::STATUS_SUCCESS) { // Mark the order with $callbackData['order_number'] as paid. } http_response_code(200); ``` 在你的`return_url`页面使用`verifyReturnUrlCallbackData()`。在v3中,顾客回来时field在query string里,所以要传入`$_GET`。向顾客显示结果,但只根据callback更新订单。原因见[验证callback和checksum](/zh/callbacks-and-checksum/)。 ## 查询付款和交易 这些调用读取Bayarcash记录的资料: ```php $intent = $bayarcash->getPaymentIntent('payment_intent_id'); $transaction = $bayarcash->getTransaction('transaction_id'); $byOrder = $bayarcash->getTransactionByOrderNumber('INV-1001'); $result = $bayarcash->getAllTransactions([ 'status' => '3', 'payment_channel' => Bayarcash::FPX, ]); // $result['data'] holds the transactions, $result['meta'] the pagination. ``` 要取消顾客还未付款的payment intent,调用`$bayarcash->cancelPaymentIntent('payment_intent_id')`。 ## 处理错误 调用失败时,会抛出`Bayarcash\Exceptions`中的exception: | Exception | HTTP状态 | 怎么做 | |---|---|---| | `ValidationException` | 422 | 修正request。`$e->errors()`会列出相关field。 | | `FailedActionException` | 400 | 阅读`$e->getMessage()`了解原因。 | | `NotFoundException` | 404 | 检查你查询的ID。 | | `RateLimitExceededException` | 429 | 稍等。`$e->rateLimitResetsAt`里有重设时间。 | ## 小贴士 - **先在sandbox测试整个流程**。创建一笔付款,然后付款。换成正式key之前,确认你的callback会把订单标为已付款。 - **不要把token和API Secret Key写在代码里**。像上面的示例一样,从环境变量或框架的secret store读取。 - **使用渠道constant,不要用数字。**`Bayarcash::FPX`比`1`更容易看懂,README列出了每个渠道constant。 ## 常见问题 ### 更新SDK后,我收到:Class "Webimpian\BayarcashSdk\Bayarcash" not found。改了什么? SDK第3版把namespace改名为Bayarcash。把你的import改为use Bayarcash\Bayarcash;(以及Bayarcash\Fpx、Bayarcash\FpxDirectDebit)。新项目也应该安装bayarcash/php-sdk,而不是旧的webimpian/bayarcash-php-sdk package。 ### 我收到“The getTransactionByOrderNumber method is only available for API version v3.”。为什么? SDK一开始使用API v2。创建client后,在发出任何request之前,马上调用$bayarcash->setApiVersion('v3')。 ### createPaymentIntent抛出ValidationException。怎样查看哪里出错? 对这个exception调用$e->errors()。它会列出API拒绝的每个field,例如超出允许范围的金额,或超过30个字符的订单号码。 --- # Callback URL and checksum: verify Bayarcash callbacks > Set your Bayarcash callback URL (webhook) and return URL. Sign each request and verify each callback with an HMAC-SHA256 checksum. > > Source: https://docs.bayarcash.com/callbacks-and-checksum/ When a payment finishes, Bayarcash tells your server with a **callback** and sends your customer back with a **return URL**. Every callback carries a `checksum`: check it with your API Secret Key before you trust the data. You can also add a checksum to your own requests so Bayarcash knows they were not changed. ## Callback URL and return URL You set both URLs on each payment intent (`callback_url` and `return_url`). They do different jobs: | | Callback URL | Return URL | |---|---|---| | Who calls it | Bayarcash's server, directly to yours | Your customer's browser, redirected by Bayarcash | | How it arrives | POST | GET with the fields in the query string (API v3) | | Can you trust it for the order status? | Yes, after checking the checksum | No: the customer can close the tab or change the URL | | Use it to | Mark the order paid or failed | Show the customer a result page | Update your orders from the callback only. If the return URL arrives first, show a "payment is being confirmed" message and wait for the callback, or look the transaction up with the API. ## Callbacks Bayarcash sends Each callback has a `record_type` field that tells you what it is: | Callback | When it is sent | |---|---| | Pre-transaction | Early in the payment, before the transaction record is final. | | Transaction | When a payment reaches a final state (successful, failed, cancelled and so on). | | Direct Debit authorization | When a customer completes or abandons e-mandate enrolment. | | Direct Debit bank approval | When the customer's bank approves or rejects a mandate. This can come days later. | | Direct Debit transaction | For each collection taken from an active mandate. | The `status` field in a transaction callback is a number: | Status | Meaning | |---|---| | 0 | New | | 1 | Pending | | 2 | Unsuccessful | | 3 | Successful | | 4 | Cancelled | | 5 | Abandoned | ## Answer every callback with HTTP 200 Your callback URL must answer **HTTP 200** once it has checked and saved the result. If it answers with any other status, or does not answer, Bayarcash sends the callback again. So your handler must be safe to run twice: check whether you have already processed that `transaction_id` before you fulfil the order. Callbacks are sent as a POST. The Bayarcash plugins and SDKs read them as form fields (`$_POST` in PHP). If your framework receives `application/json`, read the JSON body instead. ## How the checksum works The same rule signs requests and verifies callbacks. Only the list of fields changes from call to call. To build a checksum: 1. Take the fields that belong to that call (see the table below), with their values exactly as sent or received. Use an empty value for a field that is missing. 2. Sort the fields by field name, A to Z. 3. Join the values, in that order, with a `|` between each. 4. Compute an HMAC-SHA256 of that text, using your API Secret Key as the key. The result, as lowercase hex, is the checksum. For a callback, compare your result with the `checksum` field the callback carries. Use a constant-time comparison, such as `hash_equals()` in PHP or `hmac.compare_digest()` in Python. If they differ, reject the callback. A checksum on a request is optional but recommended. A checksum on a callback is always there: always verify it. ## Fields in each checksum Each call uses its own fields: | Call | Fields in the checksum | |---|---| | Create payment intent (request) | `payment_channel`, `order_number`, `amount`, `payer_name`, `payer_email` | | Direct Debit enrolment (request) | `order_number`, `amount`, `payer_name`, `payer_email`, `payer_telephone_number`, `payer_id_type`, `payer_id`, `application_reason`, `frequency_mode` | | Pre-transaction callback | `record_type`, `exchange_reference_number`, `order_number` | | Transaction callback | `record_type`, `transaction_id`, `exchange_reference_number`, `exchange_transaction_id`, `order_number`, `currency`, `amount`, `payer_name`, `payer_email`, `payer_bank_name`, `status`, `status_description`, `datetime` | | Return URL | `transaction_id`, `exchange_reference_number`, `exchange_transaction_id`, `order_number`, `currency`, `amount`, `payer_bank_name`, `status`, `status_description` | | Direct Debit bank approval callback | `record_type`, `approval_date`, `approval_status`, `mandate_id`, `mandate_reference_number`, `order_number`, `payer_bank_code_hashed`, `payer_bank_code`, `payer_bank_account_no`, `application_type` | | Direct Debit transaction callback | `record_type`, `batch_number`, `mandate_id`, `mandate_reference_number`, `transaction_id`, `datetime`, `reference_number`, `amount`, `status`, `status_description`, `cycle` | The table lists the fields; the sort in step 2 decides the order. If a payment intent has more than one `payment_channel`, join the channel numbers with commas (`1,5`) before you add it, as the PHP SDK does. For Direct Debit maintenance requests and authorization callbacks, use the verification methods in an [official SDK](/sdks/), which carry the exact field lists. ## Example: verify a transaction callback in PHP This checks a transaction callback without the SDK. With the [PHP SDK](/php-sdk/), `verifyTransactionCallbackData()` does the same in one line. ```php function bayarcash_checksum(array $data, array $fields, string $secretKey): string { $payload = []; foreach ($fields as $field) { $payload[$field] = $data[$field] ?? ''; } ksort($payload); return hash_hmac('sha256', implode('|', $payload), $secretKey); } $fields = [ 'record_type', 'transaction_id', 'exchange_reference_number', 'exchange_transaction_id', 'order_number', 'currency', 'amount', 'payer_name', 'payer_email', 'payer_bank_name', 'status', 'status_description', 'datetime', ]; $callback = $_POST; $expected = bayarcash_checksum($callback, $fields, getenv('BAYARCASH_API_SECRET_KEY')); if (! hash_equals($expected, (string) ($callback['checksum'] ?? ''))) { http_response_code(403); exit; } // Checksum is valid: save the result, then answer 200. http_response_code(200); ``` ## Example: sign a payment intent in Python The same rule in Python, for a payment intent request: ```python def bayarcash_checksum(values: dict, secret_key: str) -> str: joined = "|".join(str(values[k]) for k in sorted(values)) return hmac.new(secret_key.encode(), joined.encode(), hashlib.sha256).hexdigest() checksum = bayarcash_checksum({ "payment_channel": "1", "order_number": "INV-1001", "amount": "10.00", "payer_name": "Ahmad bin Abdullah", "payer_email": "ahmad@example.com", }, "YOUR_API_SECRET_KEY") ``` Send the result as `checksum` with the other fields. The full field reference is in the [API reference checksum guide](https://api-reference.bayarcash.com/#tag/checksum). ## Tips - **Use HTTPS for your callback and return URLs.** The callback carries payment details, and HTTPS keeps them private in transit. - **Keep the API Secret Key on your server only.** Anyone with it can forge a callback that passes the checksum check. - **Use your framework package if you have one.** The Laravel and Django packages add a callback route that checks the checksum and rejects a bad one with HTTP 403. ## Common issues ### My WooCommerce log says "Invalid checksum for order". What is wrong? The checksum did not match. Most often the API Secret Key is wrong, or it comes from the other environment (a sandbox key on a production callback, or the reverse). Copy the key again from the merchant dashboard you are using. ### My checksum never matches, even with the right key. What should I check? Use the exact field list for that call, sort by field name, and use the values exactly as sent or received. 10.00 and 10 give different checksums. A missing field counts as an empty value, not as a skipped one. ### Why did the same callback arrive twice? Bayarcash sends a callback again when your server does not answer with HTTP 200. Answer 200 once you have saved the result, and check the transaction ID so you do not process the same payment twice. --- # Callback URL & checksum: sahkan callback Bayarcash > Tetapkan callback URL (webhook) dan return URL Bayarcash anda. Tandatangani setiap request dan sahkan setiap callback dengan checksum HMAC-SHA256. > > Source: https://docs.bayarcash.com/ms/callbacks-and-checksum/ Apabila bayaran selesai, Bayarcash memaklumkan server anda melalui **callback** dan menghantar pelanggan kembali melalui **return URL**. Setiap callback membawa `checksum`. Semak checksum itu dengan API Secret Key anda sebelum anda mempercayai data itu. Anda juga boleh menambah checksum pada request anda supaya Bayarcash tahu request itu tidak diubah. ## Callback URL & return URL Anda menetapkan kedua-dua URL pada setiap payment intent (`callback_url` dan `return_url`). Fungsi kedua-duanya berbeza: | | Callback URL | Return URL | |---|---|---| | Siapa yang memanggilnya | Server Bayarcash, terus ke server anda | Browser pelanggan anda, selepas Bayarcash membuat redirect | | Cara ia sampai | POST | GET dengan field dalam query string (API v3) | | Boleh dipercayai untuk status pesanan? | Ya, selepas anda menyemak checksum | Tidak. Pelanggan boleh menutup tab atau menukar URL | | Guna untuk | Tandakan pesanan sebagai sudah dibayar atau gagal | Paparkan page keputusan kepada pelanggan | Kemas kini pesanan anda daripada callback sahaja. Jika return URL sampai dahulu, paparkan mesej "bayaran sedang disahkan" dan tunggu callback. Anda juga boleh menyemak transaksi itu dengan API. ## Callback yang Bayarcash hantar Setiap callback ada field `record_type` yang menunjukkan jenis callback itu: | Callback | Bila ia dihantar | |---|---| | Pre-transaction | Pada awal proses bayaran, sebelum rekod transaksi muktamad. | | Transaction | Apabila bayaran mencapai status akhir (berjaya, gagal, dibatalkan dan sebagainya). | | Direct Debit authorization | Apabila pelanggan melengkapkan atau meninggalkan enrolment e-Mandate. | | Direct Debit bank approval | Apabila bank pelanggan meluluskan atau menolak mandate. Callback ini boleh sampai beberapa hari kemudian. | | Direct Debit transaction | Untuk setiap collection yang diambil daripada mandate yang aktif. | Field `status` dalam callback transaksi ialah nombor: | Status | Maksud | |---|---| | 0 | New | | 1 | Pending | | 2 | Unsuccessful | | 3 | Successful | | 4 | Cancelled | | 5 | Abandoned | ## Balas setiap callback dengan HTTP 200 Callback URL anda mesti membalas **HTTP 200** selepas ia menyemak dan menyimpan keputusan. Jika ia membalas dengan status lain, atau tidak membalas, Bayarcash akan menghantar callback itu semula. Jadi, handler anda mesti selamat untuk dijalankan dua kali. Sebelum anda memproses pesanan, semak sama ada anda sudah memproses `transaction_id` itu. Callback dihantar sebagai POST. Plugin dan SDK Bayarcash membaca callback sebagai form field (`$_POST` dalam PHP). Jika framework anda menerima `application/json`, baca body JSON. ## Cara checksum berfungsi Peraturan yang sama digunakan untuk menandatangani request dan mengesahkan callback. Hanya senarai field yang berbeza bagi setiap panggilan. Untuk membina checksum: 1. Ambil field bagi panggilan itu (lihat jadual di bawah), dengan nilai tepat seperti yang dihantar atau diterima. Guna nilai kosong untuk field yang tiada. 2. Susun field mengikut nama field, A hingga Z. 3. Gabungkan nilai mengikut susunan itu, dengan `|` di antara setiap nilai. 4. Kira HMAC-SHA256 bagi teks itu, dengan API Secret Key anda sebagai key. Hasilnya, dalam hex huruf kecil, ialah checksum. Untuk callback, bandingkan hasil anda dengan field `checksum` dalam callback itu. Guna perbandingan constant-time, seperti `hash_equals()` dalam PHP atau `hmac.compare_digest()` dalam Python. Jika kedua-duanya berbeza, tolak callback itu. Checksum pada request adalah pilihan, tetapi kami mengesyorkannya. Setiap callback sentiasa ada checksum, jadi sentiasa sahkan checksum itu. ## Field dalam setiap checksum Setiap panggilan menggunakan senarai field sendiri: | Panggilan | Field dalam checksum | |---|---| | Cipta payment intent (request) | `payment_channel`, `order_number`, `amount`, `payer_name`, `payer_email` | | Enrolment Direct Debit (request) | `order_number`, `amount`, `payer_name`, `payer_email`, `payer_telephone_number`, `payer_id_type`, `payer_id`, `application_reason`, `frequency_mode` | | Callback pre-transaction | `record_type`, `exchange_reference_number`, `order_number` | | Callback transaction | `record_type`, `transaction_id`, `exchange_reference_number`, `exchange_transaction_id`, `order_number`, `currency`, `amount`, `payer_name`, `payer_email`, `payer_bank_name`, `status`, `status_description`, `datetime` | | Return URL | `transaction_id`, `exchange_reference_number`, `exchange_transaction_id`, `order_number`, `currency`, `amount`, `payer_bank_name`, `status`, `status_description` | | Callback Direct Debit bank approval | `record_type`, `approval_date`, `approval_status`, `mandate_id`, `mandate_reference_number`, `order_number`, `payer_bank_code_hashed`, `payer_bank_code`, `payer_bank_account_no`, `application_type` | | Callback Direct Debit transaction | `record_type`, `batch_number`, `mandate_id`, `mandate_reference_number`, `transaction_id`, `datetime`, `reference_number`, `amount`, `status`, `status_description`, `cycle` | Jadual ini menyenaraikan field sahaja. Susunannya ditentukan oleh langkah 2. Jika payment intent ada lebih daripada satu `payment_channel`, gabungkan nombor saluran dengan koma (`1,5`) sebelum anda menambahnya, seperti yang PHP SDK buat. Untuk request maintenance dan callback authorization Direct Debit, guna method pengesahan dalam [SDK rasmi](/ms/sdks/). Method itu ada senarai field yang tepat. ## Contoh: sahkan callback transaksi dalam PHP Kod ini menyemak callback transaksi tanpa SDK. Dengan [PHP SDK](/ms/php-sdk/), `verifyTransactionCallbackData()` membuat semakan yang sama dalam satu baris. ```php function bayarcash_checksum(array $data, array $fields, string $secretKey): string { $payload = []; foreach ($fields as $field) { $payload[$field] = $data[$field] ?? ''; } ksort($payload); return hash_hmac('sha256', implode('|', $payload), $secretKey); } $fields = [ 'record_type', 'transaction_id', 'exchange_reference_number', 'exchange_transaction_id', 'order_number', 'currency', 'amount', 'payer_name', 'payer_email', 'payer_bank_name', 'status', 'status_description', 'datetime', ]; $callback = $_POST; $expected = bayarcash_checksum($callback, $fields, getenv('BAYARCASH_API_SECRET_KEY')); if (! hash_equals($expected, (string) ($callback['checksum'] ?? ''))) { http_response_code(403); exit; } // Checksum is valid: save the result, then answer 200. http_response_code(200); ``` ## Contoh: tandatangani payment intent dalam Python Peraturan yang sama dalam Python, untuk request payment intent: ```python def bayarcash_checksum(values: dict, secret_key: str) -> str: joined = "|".join(str(values[k]) for k in sorted(values)) return hmac.new(secret_key.encode(), joined.encode(), hashlib.sha256).hexdigest() checksum = bayarcash_checksum({ "payment_channel": "1", "order_number": "INV-1001", "amount": "10.00", "payer_name": "Ahmad bin Abdullah", "payer_email": "ahmad@example.com", }, "YOUR_API_SECRET_KEY") ``` Hantar hasilnya sebagai `checksum` bersama field yang lain. Rujukan penuh untuk field ada dalam [panduan checksum dalam rujukan API](https://api-reference.bayarcash.com/#tag/checksum). ## Tips - **Guna HTTPS untuk callback URL dan return URL anda.** Callback membawa butiran bayaran, dan HTTPS melindungi butiran itu semasa dihantar. - **Simpan API Secret Key di server anda sahaja.** Sesiapa yang ada key ini boleh memalsukan callback yang lulus semakan checksum. - **Guna pakej framework jika ada untuk framework anda.** Pakej Laravel dan Django menambah route callback yang menyemak checksum dan menolak checksum yang salah dengan HTTP 403. ## Isu biasa ### Kenapa log WooCommerce saya memaparkan "Invalid checksum for order"? Checksum tidak sepadan. Biasanya API Secret Key salah, atau key itu dari environment yang lain (key sandbox pada callback production, atau sebaliknya). Copy key itu semula dari merchant dashboard yang anda gunakan. ### Kenapa checksum saya tidak pernah sepadan walaupun key saya betul? Guna senarai field yang tepat untuk panggilan itu, susun mengikut nama field, dan guna nilai tepat seperti yang dihantar atau diterima. 10.00 dan 10 menghasilkan checksum yang berbeza. Field yang tiada dikira sebagai nilai kosong. Jangan langkau field itu. ### Kenapa callback yang sama sampai dua kali? Bayarcash menghantar callback semula apabila server anda tidak membalas dengan HTTP 200. Balas dengan 200 selepas anda menyimpan keputusan. Semak juga ID transaksi supaya anda tidak memproses bayaran yang sama dua kali. --- # Callback URL和checksum:验证Bayarcash callback > 设置callback URL(webhook)和return URL。用HMAC-SHA256 checksum签署request并验证callback。 > > Source: https://docs.bayarcash.com/zh/callbacks-and-checksum/ 付款完成时,Bayarcash会用**callback**通知你的服务器,并通过**return URL**把你的顾客送回来。每个callback都带有`checksum`:在信任这些资料之前,先用你的API Secret Key检查它。你也可以在自己的request中加上checksum,让Bayarcash知道它们没有被修改。 ## Callback URL和return URL 你在每个payment intent上设置这两个URL(`callback_url`和`return_url`)。它们的作用不同: | | Callback URL | Return URL | |---|---|---| | 由谁调用 | Bayarcash的服务器,直接调用你的服务器 | 你顾客的浏览器,由Bayarcash重定向 | | 怎样到达 | POST | GET,field在query string中(API v3) | | 可以用来判断订单状态吗? | 可以,在检查checksum之后 | 不可以:顾客可能关闭标签页或修改URL | | 用途 | 把订单标为已付款或失败 | 向顾客显示结果页面 | 只根据callback更新订单。如果return URL先到达,就显示“付款确认中”的信息并等待callback,或用API查询这笔交易。 ## Bayarcash发送的callback 每个callback都有一个`record_type` field,告诉你它是什么: | Callback | 什么时候发送 | |---|---| | Pre-transaction | 在付款初期,交易记录还未确定之前。 | | Transaction | 付款到达最终状态时(成功、失败、取消等)。 | | Direct Debit authorization | 顾客完成或放弃e-Mandate登记时。 | | Direct Debit bank approval | 顾客的银行批准或拒绝授权(mandate)时。这可能在几天后才发生。 | | Direct Debit transaction | 每次从有效的mandate扣款时。 | 交易callback中的`status` field是一个数字: | 状态 | 意思 | |---|---| | 0 | New(新建) | | 1 | Pending(待处理) | | 2 | Unsuccessful(不成功) | | 3 | Successful(成功) | | 4 | Cancelled(已取消) | | 5 | Abandoned(已放弃) | ## 每个callback都以HTTP 200回复 你的callback URL在检查并保存结果后,必须回复**HTTP 200**。如果它回复其他状态,或没有回复,Bayarcash会再次发送callback。所以你的handler必须可以安全地运行两次:在完成订单前,先检查你是否已经处理过那个`transaction_id`。 Callback以POST发送。Bayarcash插件和SDK把它们当作表单field读取(PHP中的`$_POST`)。如果你的框架收到的是`application/json`,就改为读取JSON body。 ## Checksum怎样运作 签署request和验证callback使用同一个规则。每个调用之间只有field列表不同。要生成checksum: 1. 取出属于该调用的field(见下表),值必须和发送或收到的完全一样。缺少的field用空值。 2. 按field名称从A到Z排序。 3. 按这个顺序把值连接起来,每个值之间加一个`|`。 4. 用你的API Secret Key作为key,计算这段文字的HMAC-SHA256。结果以小写十六进制(hex)表示,就是checksum。 验证callback时,把你的结果和callback带来的`checksum` field比较。使用固定时间比较(constant-time comparison),例如PHP的`hash_equals()`或Python的`hmac.compare_digest()`。如果两者不同,就拒绝这个callback。 request上的checksum是可选的,但建议加上。callback上一定有checksum:一定要验证它。 ## 每个checksum中的field 每个调用使用自己的field: | 调用 | Checksum中的field | |---|---| | 创建payment intent(request) | `payment_channel`, `order_number`, `amount`, `payer_name`, `payer_email` | | Direct Debit登记(request) | `order_number`, `amount`, `payer_name`, `payer_email`, `payer_telephone_number`, `payer_id_type`, `payer_id`, `application_reason`, `frequency_mode` | | Pre-transaction callback | `record_type`, `exchange_reference_number`, `order_number` | | Transaction callback | `record_type`, `transaction_id`, `exchange_reference_number`, `exchange_transaction_id`, `order_number`, `currency`, `amount`, `payer_name`, `payer_email`, `payer_bank_name`, `status`, `status_description`, `datetime` | | Return URL | `transaction_id`, `exchange_reference_number`, `exchange_transaction_id`, `order_number`, `currency`, `amount`, `payer_bank_name`, `status`, `status_description` | | Direct Debit bank approval callback | `record_type`, `approval_date`, `approval_status`, `mandate_id`, `mandate_reference_number`, `order_number`, `payer_bank_code_hashed`, `payer_bank_code`, `payer_bank_account_no`, `application_type` | | Direct Debit transaction callback | `record_type`, `batch_number`, `mandate_id`, `mandate_reference_number`, `transaction_id`, `datetime`, `reference_number`, `amount`, `status`, `status_description`, `cycle` | 表格只列出field,顺序由第2步的排序决定。如果一个payment intent有多个`payment_channel`,先用逗号把渠道编号连接起来(`1,5`)再加入,和PHP SDK的做法一样。Direct Debit的修改request和authorization callback,请使用[官方SDK](/zh/sdks/)中的验证方法,它们带有准确的field列表。 ## 示例:用PHP验证交易callback 这段代码不使用SDK来检查交易callback。使用[PHP SDK](/zh/php-sdk/)时,`verifyTransactionCallbackData()`一行就能做到同样的事。 ```php function bayarcash_checksum(array $data, array $fields, string $secretKey): string { $payload = []; foreach ($fields as $field) { $payload[$field] = $data[$field] ?? ''; } ksort($payload); return hash_hmac('sha256', implode('|', $payload), $secretKey); } $fields = [ 'record_type', 'transaction_id', 'exchange_reference_number', 'exchange_transaction_id', 'order_number', 'currency', 'amount', 'payer_name', 'payer_email', 'payer_bank_name', 'status', 'status_description', 'datetime', ]; $callback = $_POST; $expected = bayarcash_checksum($callback, $fields, getenv('BAYARCASH_API_SECRET_KEY')); if (! hash_equals($expected, (string) ($callback['checksum'] ?? ''))) { http_response_code(403); exit; } // Checksum is valid: save the result, then answer 200. http_response_code(200); ``` ## 示例:用Python签署payment intent 同一个规则的Python版本,用于payment intent request: ```python def bayarcash_checksum(values: dict, secret_key: str) -> str: joined = "|".join(str(values[k]) for k in sorted(values)) return hmac.new(secret_key.encode(), joined.encode(), hashlib.sha256).hexdigest() checksum = bayarcash_checksum({ "payment_channel": "1", "order_number": "INV-1001", "amount": "10.00", "payer_name": "Ahmad bin Abdullah", "payer_email": "ahmad@example.com", }, "YOUR_API_SECRET_KEY") ``` 把结果作为`checksum`,和其他field一起发送。完整的field参考在[API参考文档的checksum指南](https://api-reference.bayarcash.com/#tag/checksum)。 ## 小贴士 - **你的callback URL和return URL要使用HTTPS**。callback带有付款资料,HTTPS能在传输过程中保护这些资料。 - **API Secret Key只能保存在你的服务器上**。任何拿到它的人,都能伪造一个通过checksum检查的callback。 - **如果你的框架有package,就使用它**。Laravel和Django package会加入一个callback route,自动检查checksum,并以HTTP 403拒绝无效的callback。 ## 常见问题 ### 我的WooCommerce日志显示“Invalid checksum for order”。哪里出错了? checksum不匹配。最常见的原因是API Secret Key错误,或它来自另一个环境(在正式环境的callback上用了sandbox key,或反过来)。从你正在使用的商家后台重新复制key。 ### 即使key正确,我的checksum还是一直不匹配。应该检查什么? 使用该调用的准确field列表,按field名称排序,并完全按照发送或收到的值使用。10.00和10会得出不同的checksum。缺少的field算作空值,不是跳过不算。 ### 为什么同一个callback到达了两次? 当你的服务器没有以HTTP 200回复时,Bayarcash会再次发送callback。保存结果后就回复200,并检查交易ID,以免同一笔付款被处理两次。 --- # Use Bayarcash in n8n > Install the Bayarcash community node in n8n, connect it with your Personal Access Token, and create payments or read transactions in a workflow. > > Source: https://docs.bayarcash.com/n8n/ The Bayarcash node for [n8n](https://n8n.io) lets a workflow create payment intents, check them, and read your portals and transactions without code. It is a community node, published on npm as `n8n-nodes-bayarcash`, and uses Bayarcash API v3. ## Install the node Community nodes can be installed on self-hosted n8n. To install it: 1. In n8n, open **Settings** → **Community Nodes**. 2. Install the npm package [`n8n-nodes-bayarcash`](https://www.npmjs.com/package/n8n-nodes-bayarcash). 3. Search for **Bayarcash** when you add a node to a workflow. The n8n guide to [installing community nodes](https://docs.n8n.io/integrations/community-nodes/installation/) has the full steps and other ways to install. ## Connect your Bayarcash account The node signs in with a credential called **Bayarcash API**. To create it: 1. Add a **Bayarcash** node, and under the credential choose to create a new one. 2. Fill in the fields: | Field | What to enter | |---|---| | **Personal Access Token (PAT)** | Your Personal Access Token from the merchant dashboard. | | **Environment** | **Sandbox - api.console.bayarcash-sandbox.com/v3** while you test, or **Production - api.console.bayar.cash/v3** for real payments. It is set to **Production** until you change it. | 3. Save. n8n tests the credential by listing your portals. Use a sandbox token with **Sandbox** and a production token with **Production**. They do not work across environments. ## What the node can do Choose a **Resource**, then an **Operation**: | Resource | Operation | What it does | |---|---|---| | Payment Intent | **Create** | Creates a payment and returns the `url` to send your customer to. | | Payment Intent | **Get Status** | Gets a payment intent by its **Payment Intent ID**. | | Payment Intent | **Delete** | Cancels a payment intent by its **Payment Intent ID**. | | Portal | **List All Portals** | Lists your portals. | | Portal | **Get Portal Channels** | Gets one portal, with its payment channels, by **Portal ID**. | | Transaction | **Get Transaction by ID** | Gets one transaction by its **Transaction ID**. | | Transaction | **List Transactions** | Lists transactions. Add **Filters** for **Order Number**, **Status**, **Payment Channel**, **Exchange Reference Number** or **Payer Email**. | ## Create a payment intent To create a payment from a workflow: 1. Add a **Bayarcash** node and choose **Payment Intent** → **Create**. 2. Choose the portal in **Portal Name or ID**. The list comes from your account. 3. Fill in **Order Number**, **Amount**, **Payer Name** and **Payer Email**. These are required. 4. Optionally choose one or more **Payment Channel** values. Leave it empty to let the customer choose on the Bayarcash page. 5. Optionally fill in **Payer Telephone Number**, **Callback URL** and **Return URL**. 6. Run the node. Send the `url` from its output to your customer, for example by email or WhatsApp. ## Receive the result in n8n The Bayarcash node does not start workflows by itself. To act when a payment finishes: 1. Start a second workflow with n8n's **Webhook** node, set to receive a POST. 2. Put that webhook's URL in **Callback URL** when you create the payment intent. 3. In the callback workflow, verify the `checksum` with your API Secret Key before you trust the data. See [Verify callbacks and checksums](/callbacks-and-checksum/). 4. Use **Get Transaction by ID** with the callback's `transaction_id` to read the full, current record. Make the webhook answer with HTTP 200, or Bayarcash sends the callback again. ## Tips - **Build the workflow on the sandbox first.** Switch the credential's **Environment** to **Production**, with a production token, only once a test payment runs end to end. - **Keep the order number unique for each payment.** It is how you match a callback or transaction back to the row, deal or invoice that started the workflow. ## Common issues ### The node fails with "Authentication failed: Invalid or expired PAT token. Please check your credentials." What should I check? Check that you pasted the whole Personal Access Token, and that Environment matches where the token came from. A sandbox token only works with Sandbox, and a production token only with Production. ### Creating a payment intent fails with "Forbidden" and mentions the payment channel. Why? The channel you chose in Payment Channel is not enabled on your account. New accounts only have FPX. Choose another channel, leave the field empty, or ask Bayarcash to enable the channel. ### Why does Get Portal Channels say the resource does not exist? Portal ID needs the portal's ID, not its portal key. Run List All Portals first and copy the ID from its output. --- # Guna Bayarcash dalam n8n > Install community node Bayarcash dalam n8n, sambungkan dengan Personal Access Token anda, dan cipta bayaran atau baca transaksi dalam workflow. > > Source: https://docs.bayarcash.com/ms/n8n/ Dengan node Bayarcash untuk [n8n](https://n8n.io), workflow anda boleh mencipta dan menyemak payment intent, serta membaca portal dan transaksi anda tanpa kod. Node ini ialah community node, diterbitkan di npm sebagai `n8n-nodes-bayarcash`, dan menggunakan Bayarcash API v3. ## Install node Community node boleh di-install pada n8n self-hosted. Untuk install node ini: 1. Dalam n8n, buka **Settings** → **Community Nodes**. 2. Install pakej npm [`n8n-nodes-bayarcash`](https://www.npmjs.com/package/n8n-nodes-bayarcash). 3. Cari **Bayarcash** apabila anda menambah node pada workflow. Panduan n8n tentang [cara install community node](https://docs.n8n.io/integrations/community-nodes/installation/) ada langkah penuh dan cara install yang lain. ## Sambungkan akaun Bayarcash anda Node ini log masuk dengan credential bernama **Bayarcash API**. Untuk mencipta credential itu: 1. Tambah node **Bayarcash**. Di bawah credential, pilih untuk mencipta credential baru. 2. Isi ruangan ini: | Ruangan | Apa yang perlu dimasukkan | |---|---| | **Personal Access Token (PAT)** | Personal Access Token anda dari merchant dashboard. | | **Environment** | **Sandbox - api.console.bayarcash-sandbox.com/v3** semasa anda menguji, atau **Production - api.console.bayar.cash/v3** untuk bayaran sebenar. Nilainya **Production** sehingga anda menukarnya. | 3. Simpan. n8n menguji credential itu dengan menyenaraikan portal anda. Guna token sandbox dengan **Sandbox** dan token production dengan **Production**. Token sandbox tidak berfungsi dalam production, dan sebaliknya. ## Fungsi node ini Pilih **Resource**, kemudian **Operation**: | Resource | Operation | Fungsinya | |---|---|---| | Payment Intent | **Create** | Mencipta bayaran dan memulangkan `url` untuk anda hantar kepada pelanggan. | | Payment Intent | **Get Status** | Mendapatkan payment intent mengikut **Payment Intent ID**. | | Payment Intent | **Delete** | Membatalkan payment intent mengikut **Payment Intent ID**. | | Portal | **List All Portals** | Menyenaraikan portal anda. | | Portal | **Get Portal Channels** | Mendapatkan satu portal berserta saluran bayarannya, mengikut **Portal ID**. | | Transaction | **Get Transaction by ID** | Mendapatkan satu transaksi mengikut **Transaction ID**. | | Transaction | **List Transactions** | Menyenaraikan transaksi. Tambah **Filters** untuk **Order Number**, **Status**, **Payment Channel**, **Exchange Reference Number** atau **Payer Email**. | ## Cipta payment intent Untuk mencipta bayaran dari workflow: 1. Tambah node **Bayarcash** dan pilih **Payment Intent** → **Create**. 2. Pilih portal dalam **Portal Name or ID**. Senarai ini diambil dari akaun anda. 3. Isi **Order Number**, **Amount**, **Payer Name** dan **Payer Email**. Ruangan ini wajib. 4. Jika perlu, pilih satu atau lebih nilai **Payment Channel**. Jika anda biarkan kosong, pelanggan memilih saluran sendiri di page Bayarcash. 5. Jika perlu, isi **Payer Telephone Number**, **Callback URL** dan **Return URL**. 6. Jalankan node itu. Hantar `url` dari output-nya kepada pelanggan anda, contohnya melalui e-mel atau WhatsApp. ## Terima keputusan dalam n8n Node Bayarcash tidak memulakan workflow dengan sendirinya. Untuk bertindak apabila bayaran selesai: 1. Mulakan workflow kedua dengan node **Webhook** n8n, dan tetapkan node itu untuk menerima POST. 2. Masukkan URL webhook itu dalam **Callback URL** semasa anda mencipta payment intent. 3. Dalam workflow callback itu, sahkan `checksum` dengan API Secret Key anda sebelum anda mempercayai data itu. Lihat [Sahkan callback dan checksum](/ms/callbacks-and-checksum/). 4. Guna **Get Transaction by ID** dengan `transaction_id` daripada callback untuk membaca rekod penuh yang terkini. Pastikan webhook itu membalas dengan HTTP 200. Jika tidak, Bayarcash akan menghantar callback itu semula. ## Tips - **Bina workflow pada sandbox dahulu.** Tukar **Environment** credential kepada **Production**, dengan token production, hanya selepas satu test payment berjaya sepenuhnya. - **Guna nombor pesanan yang unik untuk setiap bayaran.** Dengan nombor ini, anda boleh padankan callback atau transaksi dengan row, deal atau invois yang memulakan workflow itu. ## Isu biasa ### Kenapa node gagal dengan ralat "Authentication failed: Invalid or expired PAT token. Please check your credentials."? Pastikan anda paste keseluruhan Personal Access Token, dan Environment sepadan dengan tempat token itu dikeluarkan. Token sandbox hanya berfungsi dengan Sandbox, dan token production hanya berfungsi dengan Production. ### Kenapa saya dapat ralat "Forbidden" yang menyebut saluran bayaran semasa saya mencipta payment intent? Saluran yang anda pilih dalam Payment Channel belum diaktifkan untuk akaun anda. Akaun baru hanya ada FPX. Pilih saluran lain, biarkan ruangan itu kosong, atau minta Bayarcash mengaktifkan saluran itu. ### Kenapa Get Portal Channels kata resource itu tidak wujud? Portal ID memerlukan ID portal, bukan portal key. Jalankan List All Portals dahulu dan copy ID dari output-nya. --- # 在n8n中使用Bayarcash > 在n8n安装Bayarcash community node,用Personal Access Token连接,然后在工作流程中创建付款或读取交易。 > > Source: https://docs.bayarcash.com/zh/n8n/ [n8n](https://n8n.io)的Bayarcash node让工作流程不用写代码,就能创建和查看payment intent,并读取你的portal和交易。它是一个community node,以`n8n-nodes-bayarcash`发布在npm上,使用Bayarcash API v3。 ## 安装node community node可以安装在自托管(self-hosted)的n8n上。安装步骤如下: 1. 在n8n中,打开**Settings** → **Community Nodes**。 2. 安装npm包[`n8n-nodes-bayarcash`](https://www.npmjs.com/package/n8n-nodes-bayarcash)。 3. 在工作流程中添加node时,搜索**Bayarcash**。 n8n的[community node安装指南](https://docs.n8n.io/integrations/community-nodes/installation/)有完整步骤和其他安装方式。 ## 连接你的Bayarcash账号 这个node使用名为**Bayarcash API**的凭证登录。创建凭证的步骤如下: 1. 添加一个**Bayarcash** node,然后在凭证下选择创建新凭证。 2. 填写以下栏位: | 栏位 | 要填写什么 | |---|---| | **Personal Access Token (PAT)** | 你在商家后台(merchant dashboard)的Personal Access Token。 | | **Environment** | 测试时选**Sandbox - api.console.bayarcash-sandbox.com/v3**,真实付款选**Production - api.console.bayar.cash/v3**。在你更改之前,它默认是**Production**。 | 3. 保存。n8n会列出你的portal来测试这个凭证。 sandbox token配合**Sandbox**使用,正式环境的token配合**Production**使用。它们不能跨环境使用。 ## node能做什么 先选择**Resource**,再选择**Operation**: | Resource | Operation | 作用 | |---|---|---| | Payment Intent | **Create** | 创建一笔付款,并返回让顾客前往付款的`url`。 | | Payment Intent | **Get Status** | 按**Payment Intent ID**获取payment intent。 | | Payment Intent | **Delete** | 按**Payment Intent ID**取消payment intent。 | | Portal | **List All Portals** | 列出你的portal。 | | Portal | **Get Portal Channels** | 按**Portal ID**获取一个portal及其付款渠道。 | | Transaction | **Get Transaction by ID** | 按**Transaction ID**获取一笔交易。 | | Transaction | **List Transactions** | 列出交易。可添加**Filters**,按**Order Number**、**Status**、**Payment Channel**、**Exchange Reference Number**或**Payer Email**筛选。 | ## 创建payment intent 在工作流程中创建付款的步骤如下: 1. 添加一个**Bayarcash** node,选择**Payment Intent** → **Create**。 2. 在**Portal Name or ID**选择portal。列表来自你的账号。 3. 填写**Order Number**、**Amount**、**Payer Name**和**Payer Email**。这些是必填栏位。 4. 如有需要,选择一个或多个**Payment Channel**。留空的话,顾客会在Bayarcash页面自己选择。 5. 如有需要,填写**Payer Telephone Number**、**Callback URL**和**Return URL**。 6. 运行node。把输出中的`url`发给顾客,例如通过电邮或WhatsApp。 ## 在n8n接收付款结果 Bayarcash node不会自己启动工作流程。要在付款完成时执行操作: 1. 用n8n的**Webhook** node开始第二个工作流程,并设置为接收POST。 2. 创建payment intent时,把这个webhook的URL填入**Callback URL**。 3. 在callback工作流程中,先用你的API Secret Key验证`checksum`,再信任这些资料。请参阅[验证callback和checksum](/zh/callbacks-and-checksum/)。 4. 用**Get Transaction by ID**和callback中的`transaction_id`,读取完整的最新记录。 让webhook以HTTP 200回应,否则Bayarcash会再次发送callback。 ## 小贴士 - **先在sandbox搭建工作流程。** 等一笔测试付款从头到尾顺利完成后,才把凭证的**Environment**改成**Production**,并换上正式环境的token。 - **每笔付款使用唯一的订单号码。** 你靠它把callback或交易对应回启动工作流程的那一行、那笔deal或那张发票。 ## 常见问题 ### node出现错误“Authentication failed: Invalid or expired PAT token. Please check your credentials.”,我应该检查什么? 确认你粘贴了完整的Personal Access Token,并且Environment与token的来源环境一致。sandbox token只能配合Sandbox使用,正式环境(production)的token只能配合Production使用。 ### 创建payment intent时出现“Forbidden”,并提到付款渠道。为什么? 你在Payment Channel选择的渠道还没有在你的账号开通。新账号只有FPX。请选择其他渠道、让这个栏位留空,或请Bayarcash为你开通该渠道。 ### 为什么Get Portal Channels显示resource不存在? Portal ID需要填写portal的ID,而不是portal key。先运行List All Portals,再从它的输出复制ID。 --- # Use BCL in n8n > Install the BCL community node in n8n, connect it with a BCL API token, and create payment links or manage forms and coupons in a workflow. > > Source: https://docs.bayarcash.com/n8n-bcl/ The BCL node for [n8n](https://n8n.io) lets a workflow create BCL payment links and find transactions. It can also change your BCL forms and coupons, without code. It is a community node, published on npm as [`n8n-nodes-bcl`](https://www.npmjs.com/package/n8n-nodes-bcl). BCL takes its payments through Bayarcash. See [What is Bayarcash](/what-is-bayarcash/). To call Bayarcash API v3 directly from n8n, use the [Bayarcash node](/n8n/) instead. ## Install the node You can install community nodes on self-hosted n8n. To install it: 1. In n8n, open **Settings** → **Community Nodes**. 2. Install the npm package `n8n-nodes-bcl`. 3. Search for **BCL** when you add a node to a workflow. The [n8n guide to community nodes](https://docs.n8n.io/integrations/community-nodes/installation/) has the full steps and other ways to install. ## Connect your BCL account The node signs in with a credential called **BCL API**. To create it: 1. In BCL, create an API token. Tick **API Read**, and also **API Write** to create payment links or change forms and coupons. See [Create an API token](https://docs.bcl.my/api-tokens/). 2. In n8n, add a **BCL** node and create a new credential. 3. Paste the token into **API Token**. 4. Save. n8n tests the credential with BCL. The node always works with your live BCL account. It has no sandbox setting. ## What the node can do Choose a **Resource**, then an **Operation**: | Resource | Operation | What it does | |---|---|---| | Payment Link | **Create** | Creates a payment link. | | Payment Link | **Get Transaction** | Gets a transaction by its **Order Number**. | | Form | **List**, **Get** | Lists your forms, or gets one by **Form ID**. | | Form | **Duplicate** | Copies a form with a new title and slug. | | Form | **Update Title**, **Update Slug**, **Update Content**, **Update Status**, **Update Homepage Display** | Changes one part of a form. | | Form | **Update Stock** | Sets the stock quantity of form items. | | Form | **Update Redirect URLs** | Sets the **Success URL** and **Failed URL**. | | Form | **Update Webhook Settings** | Turns the form webhook on or off, and sets its URL and events. | | Form | **Update Affiliate Settings**, **Update Facebook Pixel**, **Update TikTok Pixel** | Changes the affiliate and tracking settings of a form. | | Coupon | **List**, **Get** | Lists your coupons, or gets one by **Coupon ID**. | | Coupon | **Update**, **Update Status** | Changes a coupon, or turns it on or off. | ## Create a payment link To create a payment link from a workflow: 1. Add a **BCL** node and choose **Payment Link** → **Create**. 2. Fill in **Amount** (in MYR), **Payer Name**, **Payer Email**, **Payer Telephone Number** and **Portal Key**. These are required. **Portal Key** is your Bayarcash portal key. See [Find your API keys](/api-keys/). 3. Optionally, open **Additional Fields** and add these: | Field | What it does | |---|---| | **Order Number** | Your own reference for the payment. BCL makes one if you leave it empty. | | **Payment Channel** | **FPX Online Banking**, **FPX Line of Credit**, **DuitNow Online Banking**, **DuitNow QR**, **SPaylater**, **Boost PayFlex**, **QRIS OB**, **QRIS Wallet** or **NETS**. | | **Let User Choose Payment** | Lets your customer choose the payment method on the payment page. | | **Remarks** | A note for the order. | 4. Run the node. Send the payment link from its output to your customer, for example by email or WhatsApp. ## Receive payments in n8n To act when a customer pays on a BCL form, let BCL call an n8n webhook: 1. Start a second workflow with the n8n **Webhook** node, and copy its URL. 2. In the BCL node, choose **Form** → **Update Webhook Settings** and enter the **Form ID**. 3. Turn on **Enabled**, paste the URL into **Webhook URL**, and choose the **Events**: **Form Submit**, **Payment Success** or **Direct Debit**. You can also set the form webhook in BCL itself. See [Payment form webhook payload](https://docs.bcl.my/webhook-payment-form/) in the BCL help centre. It also lists the fields that BCL sends. ## Tips - **Give each payment link your own order number.** Then **Get Transaction** can find the payment again. - **Use a separate token for n8n.** If you delete that token later, only n8n stops. Your other apps keep their own tokens. ## Common issues ### The node fails with "Authentication failed: Invalid or expired API token. Please check your credentials." What do I check? Check that you pasted the whole BCL API token into the BCL API credential, and that the token is not expired or deleted in BCL. See Create an API token (https://docs.bcl.my/api-tokens/) in the BCL help centre. ### Creating a payment link fails, and the message ends with "Token does not have the 'api:write' ability". Why? The token can only read. Create a new BCL API token with API Write and put it in the credential. You cannot change the permissions of a token that exists. ### The node fails with "Validation error: The API could not process your request." BCL refused one of the values. The rest of the message lists the fields. Check the payer email and the phone number format, for example 012-3456789. --- # Guna BCL dalam n8n > Install community node BCL dalam n8n, sambungkan dengan API token BCL, dan cipta payment link atau urus form dan kupon dalam workflow. > > Source: https://docs.bayarcash.com/ms/n8n-bcl/ Dengan node BCL untuk [n8n](https://n8n.io), workflow anda boleh mencipta payment link BCL dan mencari transaksi. Node ini juga boleh menukar form dan kupon BCL anda, tanpa kod. Node ini ialah community node, diterbitkan di npm sebagai [`n8n-nodes-bcl`](https://www.npmjs.com/package/n8n-nodes-bcl). BCL menerima bayaran melalui Bayarcash. Lihat [Apa itu Bayarcash & apa bezanya dengan BCL?](/ms/what-is-bayarcash/) Untuk menggunakan Bayarcash API v3 terus dari n8n, guna [node Bayarcash](/ms/n8n/). ## Install node Community node boleh di-install pada n8n self-hosted. Untuk install node ini: 1. Dalam n8n, buka **Settings** → **Community Nodes**. 2. Install pakej npm `n8n-nodes-bcl`. 3. Cari **BCL** apabila anda menambah node pada workflow. Panduan n8n tentang [cara install community node](https://docs.n8n.io/integrations/community-nodes/installation/) ada langkah penuh dan cara install yang lain. ## Sambungkan akaun BCL anda Node ini log masuk dengan credential bernama **BCL API**. Untuk mencipta credential itu: 1. Dalam BCL, cipta API token. Tandakan **API Read**. Tandakan juga **API Write** untuk mencipta payment link atau menukar form dan kupon. Lihat [Cipta API token](https://docs.bcl.my/ms/api-tokens/). 2. Dalam n8n, tambah node **BCL** dan cipta credential baru. 3. Paste token itu ke dalam **API Token**. 4. Simpan. n8n menguji credential itu dengan BCL. Node ini sentiasa menggunakan akaun BCL live anda. Node ini tiada tetapan sandbox. ## Fungsi node ini Pilih **Resource**, kemudian **Operation**: | Resource | Operation | Fungsinya | |---|---|---| | Payment Link | **Create** | Mencipta payment link. | | Payment Link | **Get Transaction** | Mendapatkan transaksi mengikut **Order Number**. | | Form | **List**, **Get** | Menyenaraikan form anda, atau mendapatkan satu form mengikut **Form ID**. | | Form | **Duplicate** | Membuat salinan form dengan tajuk dan slug baru. | | Form | **Update Title**, **Update Slug**, **Update Content**, **Update Status**, **Update Homepage Display** | Menukar satu bahagian form. | | Form | **Update Stock** | Menetapkan kuantiti stok bagi item form. | | Form | **Update Redirect URLs** | Menetapkan **Success URL** dan **Failed URL**. | | Form | **Update Webhook Settings** | On-kan atau off-kan webhook form, dan menetapkan URL dan event-nya. | | Form | **Update Affiliate Settings**, **Update Facebook Pixel**, **Update TikTok Pixel** | Menukar tetapan affiliate dan tracking bagi form. | | Coupon | **List**, **Get** | Menyenaraikan kupon anda, atau mendapatkan satu kupon mengikut **Coupon ID**. | | Coupon | **Update**, **Update Status** | Menukar kupon, atau on-kan atau off-kan kupon itu. | ## Cipta payment link Untuk mencipta payment link dari workflow: 1. Tambah node **BCL** dan pilih **Payment Link** → **Create**. 2. Isi **Amount** (dalam MYR), **Payer Name**, **Payer Email**, **Payer Telephone Number** dan **Portal Key**. Ruangan ini wajib. **Portal Key** ialah portal key Bayarcash anda. Lihat [Cari API keys anda](/ms/api-keys/). 3. Jika perlu, buka **Additional Fields** dan tambah ruangan ini: | Ruangan | Fungsinya | |---|---| | **Order Number** | Rujukan anda sendiri untuk bayaran itu. BCL akan buat nombor sendiri jika anda biarkan kosong. | | **Payment Channel** | **FPX Online Banking**, **FPX Line of Credit**, **DuitNow Online Banking**, **DuitNow QR**, **SPaylater**, **Boost PayFlex**, **QRIS OB**, **QRIS Wallet** atau **NETS**. | | **Let User Choose Payment** | Pelanggan anda memilih kaedah bayaran sendiri di page bayaran. | | **Remarks** | Nota untuk pesanan itu. | 4. Jalankan node itu. Hantar payment link dari output-nya kepada pelanggan anda, contohnya melalui e-mel atau WhatsApp. ## Terima bayaran dalam n8n Untuk bertindak apabila pelanggan membayar pada form BCL, biar BCL memanggil webhook n8n: 1. Mulakan workflow kedua dengan node **Webhook** n8n, dan copy URL-nya. 2. Dalam node BCL, pilih **Form** → **Update Webhook Settings** dan masukkan **Form ID**. 3. On-kan **Enabled**, paste URL itu ke dalam **Webhook URL**, dan pilih **Events**: **Form Submit**, **Payment Success** atau **Direct Debit**. Anda juga boleh menetapkan webhook form dalam BCL sendiri. Lihat [Payload webhook payment form](https://docs.bcl.my/ms/webhook-payment-form/) dalam Help Centre BCL. Page itu juga menyenaraikan ruangan yang BCL hantar. ## Tips - **Beri setiap payment link nombor pesanan anda sendiri.** Dengan nombor ini, **Get Transaction** boleh mencari bayaran itu semula. - **Guna token yang berasingan untuk n8n.** Jika anda delete token itu kemudian, hanya n8n yang berhenti. App anda yang lain kekal dengan token masing-masing. ## Isu biasa ### Kenapa node gagal dengan ralat "Authentication failed: Invalid or expired API token. Please check your credentials."? Pastikan anda paste keseluruhan API token BCL ke dalam credential BCL API, dan token itu belum tamat tempoh atau di-delete dalam BCL. Lihat Cipta API token (https://docs.bcl.my/ms/api-tokens/) dalam Help Centre BCL. ### Kenapa node gagal mencipta payment link, dan mesejnya berakhir dengan "Token does not have the 'api:write' ability"? Token itu hanya boleh membaca. Cipta API token BCL baru dengan API Write, dan masukkan token itu dalam credential. Anda tidak boleh menukar kebenaran token yang sudah ada. ### Kenapa node gagal dengan ralat "Validation error: The API could not process your request."? BCL menolak salah satu nilai. Bahagian lain mesej itu menyenaraikan ruangan yang berkenaan. Semak e-mel pembayar dan format nombor telefon, contohnya 012-3456789. --- # 在n8n中使用BCL > 在n8n安装BCL community node,用BCL API token连接,然后在工作流程中创建付款链接或管理表单和优惠券。 > > Source: https://docs.bayarcash.com/zh/n8n-bcl/ [n8n](https://n8n.io)的BCL node让工作流程创建BCL付款链接和查找交易。它也能修改你的BCL表单和优惠券,不用写代码。它是一个community node,以[`n8n-nodes-bcl`](https://www.npmjs.com/package/n8n-nodes-bcl)发布在npm上。 BCL通过Bayarcash收款。请参阅[什么是Bayarcash](/zh/what-is-bayarcash/)。如果要在n8n直接调用Bayarcash API v3,请改用[Bayarcash node](/zh/n8n/)。 ## 安装node 你可以在自托管(self-hosted)的n8n上安装community node。安装步骤如下: 1. 在n8n中,打开**Settings** → **Community Nodes**。 2. 安装npm包`n8n-nodes-bcl`。 3. 在工作流程中添加node时,搜索**BCL**。 [n8n的community node指南](https://docs.n8n.io/integrations/community-nodes/installation/)有完整步骤和其他安装方式。 ## 连接你的BCL账号 这个node使用名为**BCL API**的凭证登录。创建凭证的步骤如下: 1. 在BCL创建一个API token。勾选**API Read**;如果要创建付款链接或修改表单和优惠券,也勾选**API Write**。请参阅[创建API token](https://docs.bcl.my/zh/api-tokens/)。 2. 在n8n中,添加一个**BCL** node,然后创建新凭证。 3. 把token粘贴到**API Token**。 4. 保存。n8n会向BCL测试这个凭证。 这个node总是使用你的正式BCL账号。它没有sandbox设置。 ## node能做什么 先选择**Resource**,再选择**Operation**: | Resource | Operation | 作用 | |---|---|---| | Payment Link | **Create** | 创建一个付款链接。 | | Payment Link | **Get Transaction** | 按**Order Number**获取一笔交易。 | | Form | **List**、**Get** | 列出你的表单,或按**Form ID**获取一个表单。 | | Form | **Duplicate** | 复制一个表单,并设置新的标题和slug。 | | Form | **Update Title**、**Update Slug**、**Update Content**、**Update Status**、**Update Homepage Display** | 修改表单的某一部分。 | | Form | **Update Stock** | 设置表单产品的库存数量。 | | Form | **Update Redirect URLs** | 设置**Success URL**和**Failed URL**。 | | Form | **Update Webhook Settings** | 开启或关闭表单webhook,并设置它的URL和事件。 | | Form | **Update Affiliate Settings**、**Update Facebook Pixel**、**Update TikTok Pixel** | 修改表单的affiliate和追踪设置。 | | Coupon | **List**、**Get** | 列出你的优惠券,或按**Coupon ID**获取一张优惠券。 | | Coupon | **Update**、**Update Status** | 修改优惠券,或开启、关闭优惠券。 | ## 创建付款链接 在工作流程中创建付款链接的步骤如下: 1. 添加一个**BCL** node,选择**Payment Link** → **Create**。 2. 填写**Amount**(以MYR计)、**Payer Name**、**Payer Email**、**Payer Telephone Number**和**Portal Key**。这些是必填栏位。**Portal Key**是你的Bayarcash portal key。请参阅[找到你的API key](/zh/api-keys/)。 3. 如有需要,打开**Additional Fields**,添加以下栏位: | 栏位 | 作用 | |---|---| | **Order Number** | 你自己为这笔付款设的参考号码。如果留空,BCL会自动生成一个。 | | **Payment Channel** | **FPX Online Banking**、**FPX Line of Credit**、**DuitNow Online Banking**、**DuitNow QR**、**SPaylater**、**Boost PayFlex**、**QRIS OB**、**QRIS Wallet**或**NETS**。 | | **Let User Choose Payment** | 让顾客在付款页面自己选择付款方式。 | | **Remarks** | 订单备注。 | 4. 运行node。把输出中的付款链接发给顾客,例如通过电邮或WhatsApp。 ## 在n8n接收付款 要在顾客通过BCL表单付款时执行操作,让BCL调用一个n8n webhook: 1. 用n8n的**Webhook** node开始第二个工作流程,并复制它的URL。 2. 在BCL node中,选择**Form** → **Update Webhook Settings**,然后输入**Form ID**。 3. 开启**Enabled**,把URL粘贴到**Webhook URL**,然后选择**Events**:**Form Submit**、**Payment Success**或**Direct Debit**。 你也可以直接在BCL设置表单webhook。请参阅BCL帮助中心的[付款表单webhook payload](https://docs.bcl.my/zh/webhook-payment-form/)。该页面也列出BCL发送的栏位。 ## 小贴士 - **为每个付款链接设定你自己的订单号码。** 这样**Get Transaction**就能再次找到这笔付款。 - **为n8n使用单独的token。** 以后删除这个token时,只有n8n会停止运作。你的其他App仍使用各自的token。 ## 常见问题 ### node出现错误“Authentication failed: Invalid or expired API token. Please check your credentials.”,我应该检查什么? 确认你把完整的BCL API token粘贴到BCL API凭证中,并且这个token在BCL里没有过期或被删除。请参阅BCL帮助中心的创建API token (https://docs.bcl.my/zh/api-tokens/)。 ### 创建付款链接失败,信息最后是“Token does not have the 'api:write' ability”。为什么? 这个token只能读取。请创建一个带有API Write的新BCL API token,并把它填入凭证。已有token的权限不能更改。 ### node出现错误“Validation error: The API could not process your request.” BCL拒绝了其中一个值。信息的其余部分会列出相关栏位。请检查付款人的电邮和电话号码格式,例如012-3456789。 --- # Use Bayarcash with Claude and other AI assistants (MCP) > Install the Bayarcash MCP server so Claude, Cursor and other AI assistants can create payments and read your transactions. > > Source: https://docs.bayarcash.com/bayarcash-mcp/ The Bayarcash MCP server lets an AI assistant work with your Bayarcash account. MCP (Model Context Protocol) is the standard that Claude, Cursor and other AI apps use to connect to other systems. You ask in plain words, for example "Create a payment for RM 100", and the assistant calls Bayarcash API v3 for you. The server is open source: [webimpianteam/bayarcash-mcp-server](https://github.com/webimpianteam/bayarcash-mcp-server) on GitHub. It is also listed on [Smithery](https://smithery.ai/server/@webimpianteam/bayarcash-mcp-server). It runs on your own computer. ## What it can do The server gives the assistant these tools: | Tool | What it does | |---|---| | `create_payment_intent` | Creates a payment and returns its payment intent ID and payment link. | | `get_payment_intent` | Gets the status of a payment by its payment intent ID. | | `get_transaction` | Gets one transaction by its transaction ID. | | `get_transaction_by_order` | Gets one transaction by its order number. | | `list_transactions` | Lists transactions. Filters: status, payment channel, payer email, order number and reference number. | | `get_portals` | Lists your portals. | | `get_payment_channels` | Lists payment channels. | | `get_fpx_banks` | Lists the FPX banks. | To create a payment, the assistant needs an order number, amount, payer email, payer name, description and portal key. If you do not give them, it asks you, and it can show your portals so you can choose one. ## Before you start You need these before you install the server: - Node.js on your computer, to run the server. - An AI app that supports MCP, for example Claude Desktop, Claude Code or Cursor. - Your Personal Access Token (PAT) and API Secret Key. See [Find your API keys](/api-keys/). ## Install the server The server runs from a copy of its GitHub repository. To install it: 1. Clone the repository: `git clone https://github.com/webimpianteam/bayarcash-mcp-server.git` 2. In the new `bayarcash-mcp-server` folder, run `npm install`. 3. Run `npm run build`. This makes the file `build/index.js`. 4. Note the full path to `build/index.js`. Your AI app needs it. ## Connect your AI app The server reads its settings from these environment variables: | Variable | What to enter | |---|---| | `BAYARCASH_API_TOKEN` | Your Personal Access Token (PAT). Required. | | `BAYARCASH_API_SECRET_KEY` | Your API Secret Key. Required. | | `BAYARCASH_SANDBOX` | `true` for the sandbox, `false` for production. It is `true` until you change it. | For Claude Desktop, add the server to `claude_desktop_config.json`. Use the full path from step 4, and put in your own keys: ```json { "mcpServers": { "bayarcash": { "command": "node", "args": ["/full/path/to/bayarcash-mcp-server/build/index.js"], "env": { "BAYARCASH_API_TOKEN": "your_token", "BAYARCASH_API_SECRET_KEY": "your_secret", "BAYARCASH_SANDBOX": "true" } } } } ``` Then restart Claude Desktop. Other AI apps take the same command, path and variables in their MCP settings. For Claude Code, run `claude mcp add bayarcash -e BAYARCASH_API_TOKEN=your_token -e BAYARCASH_API_SECRET_KEY=your_secret -e BAYARCASH_SANDBOX=true -- node /full/path/to/bayarcash-mcp-server/build/index.js`. ## Tips - **Start on the sandbox.** The server uses the sandbox until you set `BAYARCASH_SANDBOX` to `false`. Change to production, with live keys, only when a test payment works. - **Read each payment before the assistant creates it.** Check the amount, the payer and the portal. A payment link goes to a real customer. - **Keep your keys out of shared files.** The settings file holds your token and secret key. Do not commit it to Git, and do not share it in a chat or a screenshot. ## Common issues ### The server stops with "Error: BAYARCASH_API_TOKEN and BAYARCASH_API_SECRET_KEY environment variables are required". Your AI app did not pass the two keys to the server. Add BAYARCASH_API_TOKEN and BAYARCASH_API_SECRET_KEY to the env part of the server entry in its MCP settings, then restart the app. ### The assistant says "Authentication failed. Check your API token and secret key." The keys and the environment do not match. The server uses the sandbox until you set BAYARCASH_SANDBOX to false. Use sandbox keys with the sandbox and live keys with production. See Find your API keys (/api-keys/). ### The assistant created a payment with the wrong payment channel. Why? The channel list in the server does not match the Bayarcash channel numbers for all channels. Leave the channel empty so your customer chooses on the Bayarcash page, or check the channel on the payment page before you send the link. --- # Guna Bayarcash dengan Claude & AI assistant lain (MCP) > Install MCP server Bayarcash supaya Claude, Cursor dan AI assistant lain boleh mencipta bayaran dan membaca transaksi anda. > > Source: https://docs.bayarcash.com/ms/bayarcash-mcp/ Dengan MCP server Bayarcash, AI assistant boleh berhubung dengan akaun Bayarcash anda. MCP (Model Context Protocol) ialah standard yang Claude, Cursor dan app AI lain gunakan untuk berhubung dengan sistem lain. Anda hanya minta dalam bahasa biasa, contohnya "Create a payment for RM 100", dan assistant itu menggunakan Bayarcash API v3 untuk anda. Server ini open source: [webimpianteam/bayarcash-mcp-server](https://github.com/webimpianteam/bayarcash-mcp-server) di GitHub. Server ini juga tersenarai di [Smithery](https://smithery.ai/server/@webimpianteam/bayarcash-mcp-server). Server ini berjalan pada komputer anda sendiri. ## Fungsi server ini Server ini memberi assistant tool berikut: | Tool | Fungsinya | |---|---| | `create_payment_intent` | Mencipta bayaran dan memulangkan ID payment intent dan payment link bayaran itu. | | `get_payment_intent` | Mendapatkan status bayaran mengikut ID payment intent. | | `get_transaction` | Mendapatkan satu transaksi mengikut ID transaksi. | | `get_transaction_by_order` | Mendapatkan satu transaksi mengikut nombor pesanan. | | `list_transactions` | Menyenaraikan transaksi. Filter: status, saluran bayaran, e-mel pembayar, nombor pesanan dan nombor rujukan. | | `get_portals` | Menyenaraikan portal anda. | | `get_payment_channels` | Menyenaraikan saluran bayaran. | | `get_fpx_banks` | Menyenaraikan bank FPX. | Untuk mencipta bayaran, assistant memerlukan nombor pesanan, amaun, e-mel pembayar, nama pembayar, keterangan dan portal key. Jika anda tidak memberikannya, assistant akan bertanya. Assistant juga boleh memaparkan portal anda supaya anda boleh pilih satu. ## Sebelum anda mula Sediakan perkara ini sebelum anda install server itu: - Node.js pada komputer anda, untuk menjalankan server itu. - App AI yang menyokong MCP, contohnya Claude Desktop, Claude Code atau Cursor. - Personal Access Token (PAT) dan API Secret Key anda. Lihat [Cari API keys anda](/ms/api-keys/). ## Install server Server ini berjalan dari salinan repository GitHub-nya. Untuk install server ini: 1. Clone repository itu: `git clone https://github.com/webimpianteam/bayarcash-mcp-server.git` 2. Dalam folder baru `bayarcash-mcp-server`, jalankan `npm install`. 3. Jalankan `npm run build`. Langkah ini membuat fail `build/index.js`. 4. Catat path penuh ke `build/index.js`. App AI anda memerlukannya. ## Sambungkan app AI anda Server ini membaca tetapannya dari environment variable ini: | Variable | Apa yang perlu dimasukkan | |---|---| | `BAYARCASH_API_TOKEN` | Personal Access Token (PAT) anda. Wajib. | | `BAYARCASH_API_SECRET_KEY` | API Secret Key anda. Wajib. | | `BAYARCASH_SANDBOX` | `true` untuk sandbox, `false` untuk production. Nilainya `true` sehingga anda menukarnya. | Untuk Claude Desktop, tambah server ini dalam `claude_desktop_config.json`. Guna path penuh dari langkah 4, dan masukkan keys anda sendiri: ```json { "mcpServers": { "bayarcash": { "command": "node", "args": ["/full/path/to/bayarcash-mcp-server/build/index.js"], "env": { "BAYARCASH_API_TOKEN": "your_token", "BAYARCASH_API_SECRET_KEY": "your_secret", "BAYARCASH_SANDBOX": "true" } } } } ``` Kemudian mulakan semula Claude Desktop. App AI lain menggunakan command, path dan variable yang sama dalam tetapan MCP masing-masing. Untuk Claude Code, jalankan `claude mcp add bayarcash -e BAYARCASH_API_TOKEN=your_token -e BAYARCASH_API_SECRET_KEY=your_secret -e BAYARCASH_SANDBOX=true -- node /full/path/to/bayarcash-mcp-server/build/index.js`. ## Tips - **Mula dengan sandbox.** Server ini menggunakan sandbox sehingga anda menetapkan `BAYARCASH_SANDBOX` kepada `false`. Tukar kepada production, dengan keys live, hanya selepas satu bayaran ujian berjaya. - **Semak setiap bayaran sebelum assistant menciptanya.** Semak amaun, pembayar dan portal. Payment link akan sampai kepada pelanggan sebenar. - **Jangan letak keys anda dalam fail yang dikongsi.** Fail tetapan itu menyimpan token dan secret key anda. Jangan commit fail itu ke Git, dan jangan kongsi fail itu dalam chat atau screenshot. ## Isu biasa ### Kenapa server berhenti dengan ralat "Error: BAYARCASH_API_TOKEN and BAYARCASH_API_SECRET_KEY environment variables are required"? App AI anda tidak menghantar kedua-dua keys itu kepada server. Tambah BAYARCASH_API_TOKEN dan BAYARCASH_API_SECRET_KEY pada bahagian env bagi entri server itu dalam tetapan MCP app anda, kemudian mulakan semula app itu. ### Kenapa assistant memaparkan "Authentication failed. Check your API token and secret key."? Keys anda tidak sepadan dengan environment. Server ini menggunakan sandbox sehingga anda menetapkan BAYARCASH_SANDBOX kepada false. Guna keys sandbox dengan sandbox, dan keys live dengan production. Lihat Cari API keys anda (/ms/api-keys/). ### Kenapa assistant mencipta bayaran dengan saluran bayaran yang salah? Senarai saluran dalam server ini tidak sepadan dengan nombor saluran Bayarcash bagi semua saluran. Biarkan saluran itu kosong supaya pelanggan anda memilih sendiri di page Bayarcash, atau semak saluran itu di page bayaran sebelum anda menghantar link. --- # 在Claude和其他AI助手中使用Bayarcash(MCP) > 安装Bayarcash MCP服务器,让Claude、Cursor和其他AI助手可以创建付款和读取你的交易。 > > Source: https://docs.bayarcash.com/zh/bayarcash-mcp/ Bayarcash MCP服务器让AI助手可以操作你的Bayarcash账号。MCP(Model Context Protocol)是Claude、Cursor和其他AI App用来连接其他系统的标准。你只需用日常用语提出要求,例如“Create a payment for RM 100”,助手就会替你调用Bayarcash API v3。 这个服务器是开源的:GitHub上的[webimpianteam/bayarcash-mcp-server](https://github.com/webimpianteam/bayarcash-mcp-server)。它也列在[Smithery](https://smithery.ai/server/@webimpianteam/bayarcash-mcp-server)上。它在你自己的电脑上运行。 ## 它能做什么 服务器为助手提供以下工具: | 工具 | 作用 | |---|---| | `create_payment_intent` | 创建付款,并返回它的payment intent ID和付款链接。 | | `get_payment_intent` | 按payment intent ID获取付款状态。 | | `get_transaction` | 按交易ID获取一笔交易。 | | `get_transaction_by_order` | 按订单号码获取一笔交易。 | | `list_transactions` | 列出交易。筛选条件:状态、付款渠道、付款人电邮、订单号码和参考号码。 | | `get_portals` | 列出你的portal。 | | `get_payment_channels` | 列出付款渠道。 | | `get_fpx_banks` | 列出FPX银行。 | 要创建付款,助手需要订单号码、金额、付款人电邮、付款人姓名、说明和portal key。如果你没有提供,它会问你,也可以列出你的portal让你选择。 ## 开始之前 安装服务器前,你需要准备: - 电脑上的Node.js,用来运行服务器。 - 支持MCP的AI App,例如Claude Desktop、Claude Code或Cursor。 - 你的Personal Access Token(PAT)和API Secret Key。见[找到你的API key](/zh/api-keys/)。 ## 安装服务器 服务器从它的GitHub repository副本运行。安装步骤: 1. 克隆这个repository:`git clone https://github.com/webimpianteam/bayarcash-mcp-server.git` 2. 在新的`bayarcash-mcp-server`文件夹中,运行`npm install`。 3. 运行`npm run build`。这会生成`build/index.js`文件。 4. 记下`build/index.js`的完整路径。你的AI App需要用到它。 ## 连接你的AI App 服务器从以下环境变量读取设置: | 变量 | 输入什么 | |---|---| | `BAYARCASH_API_TOKEN` | 你的Personal Access Token(PAT)。必填。 | | `BAYARCASH_API_SECRET_KEY` | 你的API Secret Key。必填。 | | `BAYARCASH_SANDBOX` | sandbox用`true`,正式环境(production)用`false`。在你修改之前,它都是`true`。 | 使用Claude Desktop时,把服务器加入`claude_desktop_config.json`。使用第4步的完整路径,并填入你自己的key: ```json { "mcpServers": { "bayarcash": { "command": "node", "args": ["/full/path/to/bayarcash-mcp-server/build/index.js"], "env": { "BAYARCASH_API_TOKEN": "your_token", "BAYARCASH_API_SECRET_KEY": "your_secret", "BAYARCASH_SANDBOX": "true" } } } } ``` 然后重新启动Claude Desktop。其他AI App在它们的MCP设置中使用相同的命令、路径和变量。使用Claude Code时,运行`claude mcp add bayarcash -e BAYARCASH_API_TOKEN=your_token -e BAYARCASH_API_SECRET_KEY=your_secret -e BAYARCASH_SANDBOX=true -- node /full/path/to/bayarcash-mcp-server/build/index.js`。 ## 小贴士 - **从sandbox开始**。在你把`BAYARCASH_SANDBOX`设为`false`之前,服务器会一直使用sandbox。等测试付款成功后,才换成正式环境和正式key。 - **助手创建付款前,先检查每笔付款**。检查金额、付款人和portal。付款链接会发给真实的顾客。 - **不要把key放在共享的文件里**。设置文件里有你的token和secret key。不要把它提交(commit)到Git,也不要在聊天或截图中分享它。 ## 常见问题 ### 服务器停止运行,并显示“Error: BAYARCASH_API_TOKEN and BAYARCASH_API_SECRET_KEY environment variables are required”。 你的AI App没有把这两个key传给服务器。在App的MCP设置中,把BAYARCASH_API_TOKEN和BAYARCASH_API_SECRET_KEY加入这个服务器条目的env部分,然后重新启动App。 ### 助手显示“Authentication failed. Check your API token and secret key.” key和环境不匹配。在你把BAYARCASH_SANDBOX设为false之前,服务器会一直使用sandbox。sandbox用sandbox key,正式环境用正式key。见找到你的API key (/zh/api-keys/)。 ### 助手用错误的付款渠道创建了付款。为什么? 服务器中的渠道列表,并不是每个渠道都和Bayarcash的渠道编号一致。把渠道留空,让你的顾客在Bayarcash页面自己选择;或在发送链接前,先在付款页面检查渠道。 --- # Check your webhook log > The Webhook Logs page shows each callback that Bayarcash sent to your website, and whether it was a success or a failure. > > Source: https://docs.bayarcash.com/webhook-log/ When a payment changes, Bayarcash sends a callback (a webhook) to your website. The **Webhook Logs** page shows each callback and its result. Use it when your shop does not update an order after a payment. ## Open the webhook log To see the callbacks: 1. Sign in to the [merchant dashboard](/sign-in/). 2. In the top menu, choose **Tools**. 3. Choose **Webhook Log**. The **Webhook Logs** page opens. 4. To find one callback, choose **Advance Filter**. The table below gives each filter. | Filter | Use it to | |---|---| | **Created Date Range** | Show the callbacks of a period | | **Status** | Show only **Success** or only **Failed** callbacks | | **Loggable Type** | Show one type of callback, for example **Transaction** | | **Reference Number** | Find the callback for one payment | *(Screenshot: The Webhook Logs page with Advance Filter open and highlighted)* The list shows the **Created** time, the **Status**, the **Loggable Type** and the **Reference Number** of each callback. ## If a callback failed A **Failed** callback means that your website did not accept it. Check that your callback URL is correct and that your website is online. Then check the checksum. See [Callbacks and checksum](/callbacks-and-checksum/). You can also check the payment itself in [Transactions](/transactions/). ## Common issues ### A customer paid, but my shop did not update the order. Where do I look? Open Tools → Webhook Log. Find the callback for that payment. If its status is Failed, your website did not accept the callback. See Callbacks and checksum (/callbacks-and-checksum/). ### How do I find the callback for one payment? Choose Advance Filter and type the Reference Number of the payment. --- # Semak webhook log anda > Page Webhook Logs memaparkan setiap callback yang Bayarcash hantar ke laman web anda, dan sama ada callback itu berjaya atau gagal. > > Source: https://docs.bayarcash.com/ms/webhook-log/ Apabila status bayaran berubah, Bayarcash menghantar callback (webhook) ke laman web anda. Page **Webhook Logs** memaparkan setiap callback dan keputusannya. Guna page ini apabila kedai online anda tidak mengemas kini pesanan selepas pelanggan membayar. ## Buka webhook log Untuk melihat callback: 1. Log masuk ke [merchant dashboard](/ms/sign-in/). 2. Di menu atas, klik **Tools**. 3. Klik **Webhook Log**. Page **Webhook Logs** dibuka. 4. Untuk mencari satu callback, klik **Advance Filter**. Jadual di bawah menerangkan setiap filter. | Filter | Guna untuk | |---|---| | **Created Date Range** | Paparkan callback bagi satu tempoh | | **Status** | Paparkan callback **Success** sahaja atau **Failed** sahaja | | **Loggable Type** | Paparkan satu jenis callback, contohnya **Transaction** | | **Reference Number** | Cari callback untuk satu bayaran | *(Screenshot: Page Webhook Logs dengan Advance Filter dibuka dan ditanda)* Senarai itu memaparkan masa **Created**, **Status**, **Loggable Type** dan **Reference Number** bagi setiap callback. ## Jika callback gagal Callback **Failed** bermaksud laman web anda tidak menerima callback itu. Pastikan callback URL anda betul dan laman web anda online. Kemudian semak checksum. Lihat [Sahkan callback dan checksum](/ms/callbacks-and-checksum/). Anda juga boleh menyemak bayaran itu sendiri. Lihat [Semak transaksi dan statusnya](/ms/transactions/). ## Isu biasa ### Di mana saya perlu semak jika pelanggan sudah bayar tetapi kedai online saya tidak mengemas kini pesanan? Buka Tools → Webhook Log. Cari callback untuk bayaran itu. Jika statusnya Failed, laman web anda tidak menerima callback itu. Lihat Sahkan callback dan checksum (/ms/callbacks-and-checksum/). ### Bagaimana saya cari callback untuk satu bayaran? Klik Advance Filter dan taip Reference Number bayaran itu. --- # 查看你的webhook记录 > Webhook Logs页面显示Bayarcash发送到你网站的每个callback,以及它是成功还是失败。 > > Source: https://docs.bayarcash.com/zh/webhook-log/ 当一笔付款有变动时,Bayarcash会发送一个callback(webhook)到你的网站。**Webhook Logs**页面显示每个callback和它的结果。如果付款后你的商店没有更新订单,就用这个页面检查。 ## 打开webhook记录 查看callback: 1. 登录[商家后台(merchant dashboard)](/zh/sign-in/)。 2. 在顶部菜单选择**Tools**。 3. 选择**Webhook Log**。**Webhook Logs**页面会打开。 4. 如果要找一个callback,选择**Advance Filter**。下表列出每个筛选条件。 | 筛选条件 | 用途 | |---|---| | **Created Date Range** | 显示某段期间的callback | | **Status** | 只显示**Success**或只显示**Failed**的callback | | **Loggable Type** | 显示一种callback,例如**Transaction** | | **Reference Number** | 找到一笔付款的callback | *(Screenshot: Webhook Logs页面,Advance Filter已打开并已标示)* 列表显示每个callback的**Created**时间、**Status**、**Loggable Type**和**Reference Number**。 ## 如果callback失败 **Failed**的callback表示你的网站没有接受它。请检查你的callback URL是否正确,以及你的网站是否在线。然后检查checksum。请看[Callback和checksum](/zh/callbacks-and-checksum/)。 你也可以在[查看交易和交易状态](/zh/transactions/)里检查这笔付款本身。 ## 常见问题 ### 顾客已经付款,但我的商店没有更新订单。我要看哪里? 打开Tools → Webhook Log。找到这笔付款的callback。如果它的状态是Failed,表示你的网站没有接受这个callback。请看Callback和checksum (/zh/callbacks-and-checksum/)。 ### 我要怎样找到一笔付款的callback? 选择Advance Filter,然后输入这笔付款的Reference Number。