跳到主要内容

概述

LawPay168 是一个面向孟加拉国 MFS 渠道（bKash / Nagad / Rocket）的支付聚合 API。本页用一张图概括你将如何与之集成。

集成的全部内容​

你的后端 ──创建订单──▶ LawPay168 API
                          │
玩家在 MFS 应用中支付 ─────┤
                          │
你的后端 ◀──Webhook 通知── LawPay168 API
                          │
你的后端 ──查询订单──────▶ LawPay168 API（任何时候都可以查）

你只关心三件事：

  1. 怎么发请求 — REST + 请求体 MD5 排序签名。详见 认证。
  2. 怎么收 Webhook — 平台在订单进入终态时回调你的 HTTPS 端点（returnUrl）。详见 Webhooks。
  3. 怎么发起付款 — 同样是 REST + 签名，调用 POST /apply/create。详见 创建付款。

核心概念​

商户（Merchant）​

你（接入方）是商户。每个商户拥有：

  • merchantId、apiSecret（凭证）
  • 每次下单指定的 returnUrl（Webhook 接收地址）
  • 默认结算货币 BDT

订单（Order）​

每次发起收款或付款都会创建一个订单，包含：

  • 订单 ID（UUID，由 LawPay168 生成）
  • 你提供的 merchant_order_id（你自己的引用号）
  • 金额（BDT）
  • 渠道（bkash / nagad / rocket）
  • 状态（见下）
  • 过期时间（收款 30 分钟，付款 24 小时）

订单状态​

收款订单：

  • pending — 已创建，等待玩家在 MFS 应用中支付
  • processing — 正在结算
  • completed — 已完成（已入账）
  • failed — 失败（不可恢复）
  • expired — 过期未支付
  • cancelled — 已取消

付款订单：

  • pending → processing → completed，或 failed / expired

渠道​

渠道代码名称
bkashbKash
nagadNagad
rocketRocket

Webhook 事件​

事件触发条件
order.completed收款订单已完成
order.failed收款订单失败
order.expired收款订单过期未支付
payout.completed付款订单已结算

典型集成步骤​

  1. 拿到凭证 — 联系平台团队获取 merchantId、apiSecret，并请求把账户标记为 demo 商户以便联调。
  2. 实现签名 — 见 认证；建议直接复制 代码示例 中的签名函数。
  3. 接入收款 — 调用 创建收款，为玩家打开返回的托管页 payUrl。
  4. 接入 Webhook — 部署一个 HTTPS 端点，按 Webhooks 文档校验签名并应答 SUCCESS。
  5. 接入付款（如需要） — 调用 创建付款，等待完成回调。
  6. 沙箱测试 — 用 isTest: true 跑合成流程，详见 测试凭证。
  7. 切到生产 — 平台清除 demo 标记并签发正式凭证；你的代码无需改动。

限额与速率​

  • 单笔金额：10 – 1,000,000 BDT（具体上下限可由平台按商户调整）
  • API 速率：默认 60 req/min/merchant，超限返回 429，详见 速率限制

下一步​

  1. 认证
  2. API 概览
  3. 代码示例