开发者文档

完整的 API 文档、SDK 和集成指南，帮助您快速接入 OTGPAY 支付系统

快速接入

从申请接入到上线运营，我们提供清晰的流程指导

1

申请接入

提交您的基本信息和业务需求

2

获取凭证

获取 API Key 和商户 ID

3

测试集成

在测试环境完成技术集成

4

生产上线

通过审核后发布到生产环境

国家集成文档

选择您的目标国家，获取该国家的详细集成指南和本地支付方式说明

logo

印度尼西亚

本地支付方式集成指南，覆盖主流支付方式，高成功率接入

查看集成文档
logo

泰国

银行转账和电子钱包接入指南，实时到账确认机制

查看集成文档
logo

巴基斯坦

本地转账通道集成，支持大额跑量业务的接入方案

查看集成文档

API 接口文档

支持多种接口，满足不同的业务需求

logo

支付接口

  • POST /api/payment/create - 创建支付订单
  • GET /api/payment/{id} - 查询支付状态
  • POST /api/payment/{id}/refund - 发起退款
logo

代付接口

  • POST /api/payout/submit - 提交代付请求
  • GET /api/payout/{id} - 查询代付状态
  • POST /api/payout/batch - 批量代付
logo

查询接口

  • GET /api/settlement/records - 获取结算记录
  • GET /api/statement - 获取账单
  • GET /api/balance - 获取账户余额

代码示例

快速上手的代码片段

JavaScript

//request
{
    "appId": 1054,
    "orderId": "M233323000059",
    "amount": "300",
    "phone": "08230219312",
    "email": "23423@qq.com",
    "name": "test",
    "inBankCode": "014",
    "payType": "QR",
    "sign": "af0gAHkUOyYHu9owQp8NJ4mPEeUW4vuJcjdxqLIzrVw8AvpLSjD1DXupReSG/CyuSkFRyiIvCp5u703AuGGmfgD2gKDH3Ywau41bAbG2jnHJ8mtjiSJ5iWUzanyd4Kr7d1+rETbzUl7/BkW3t0X8UUFdqpxwG8DPUjAwUKfplWDHV7koG51Ozexd80DCsmW6eWdouAZ1uNXGLYmV3ftE3BmfNRtuv1C5bfTJWrTEIOxbF6g2uYOFZTlIgrQgd7/2PsAYwQQXNz8Q8CYl4OxqCv4pXJxaLWPbR5tqZu9og5kn32C9aHW/NlU1y39vzz+4ef81yPAqUV9oHlSMSPrMmw=="
}

//response
{
    "status": "1",
    "error": "00000000",
    "msg": "",
    "data": {
        "orderId": "M233323000059",
        "orderNo": "6023071013539074",
        "payUrl": "https://a.api-uat.idr.com/1L9zQS2",
        "bankCode": "014",
        "qrCode": "00020101021228760011ph.ppmi.p2m0111OPDVPHM1XXX0315777148000000017041652948137245442930503001520460165303608540810000.vnd Of Mandalu62310010ph.allbank05062110000803***88310012ph.ppmi.qrph0111OPDVPHM1XXX63042763",
        "sign": "YEoA8Y2JzQFGVzwJSqmemm1Kfv/bfyIfCqv2dp7RNzT5B72AQvdD+nt2nR4sL1HWscvmNHyVt5ovAi7MMhy3ziih/sMph+wPx4YjH3W1h5DyBvSlWvaKfKrK5ViomZ0pPYWydwRHnnRnicxToHK9S6qtSy7Q73O0hdz4hJ9p41Th3ycBl2Q9SeqSZYSY1ohcPDhdyRf2y0prb8rHgpBKzxZ5BKX/1bsE9OmsSEHAEYT8OGgko6aNe8XPAhr4G48cpWTftvnGQuzh0O65nuZRI/PF+Axt2zJCVbFHDDSREI9NlAT82ebDqhlVdxQzKE67D1nxgjb3dPmDUYHOBpmwxQ=="
    }
}

安全与回调

了解如何安全地处理回调和签名验证

logo

签名验证

所有回调请求都包含数字签名，确保数据完整性和真实性

  • 1. 获取回调数据和签名
  • 2. 使用您的密钥重新计算签名
  • 3. 比较签名是否匹配
logo

Webhook 回调

系统会在支付、代付等关键事件发生时触发回调

  • payment.completed - 支付完成
  • payment.failed - 支付失败
  • payout.completed - 代付完成
  • payout.failed - 代付失败

错误码说明

常见错误码和解决方案

1001

param is null

参数为空，请检查参数是否正确

1002

Illegal Param

非法参数，请检查参数是否正确

1003

system exception

系统异常

1004

system is busy

系统繁忙

4013

order not exit

订单不存在

4014

order is already end status

订单为终态

准备好和我们合作了吗 ?

联系我们的团队，讨论您的支付需求和合作方案

联系我们