在n8n中使用BCL

n8n的BCL node让工作流程创建BCL付款链接和查找交易。它也能修改你的BCL表单和优惠券，不用写代码。它是一个community node，以n8n-nodes-bcl发布在npm上。

BCL通过Bayarcash收款。请参阅什么是Bayarcash。如果要在n8n直接调用Bayarcash API v3，请改用Bayarcash node。

安装node

你可以在自托管（self-hosted）的n8n上安装community node。安装步骤如下：

1. 在n8n中，打开Settings → Community Nodes。
2. 安装npm包n8n-nodes-bcl。
3. 在工作流程中添加node时，搜索BCL。

n8n的community node指南有完整步骤和其他安装方式。

连接你的BCL账号

这个node使用名为BCL API的凭证登录。创建凭证的步骤如下：

1. 在BCL创建一个API token。勾选API Read；如果要创建付款链接或修改表单和优惠券，也勾选API Write。请参阅创建API token。
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。

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。该页面也列出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。

创建付款链接失败，信息最后是“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。

相关文章

• 在n8n中使用Bayarcash
• 从WooCommerce订单发送BCL付款链接
• Bayarcash是什么？它和BCL有什么不同？
• 找到你的Bayarcash API key、PAT和portal key