Bulkpe 支付 API 集成指南：使用 Postman 快速发起支付

一. Bulkpe 账户设置

在开始调用 Bulkpe 支付 API 前，您需要确保拥有一个活跃的 Bulkpe 账户。

1. 注册和登录

访问 Bulkpe 官网并注册账户。
登录后，在仪表板中获取您的 API 令牌（api_token），用于后续 API 调用授权。

二. 导入 Bulkpe Postman 集合

Postman 是常用的 API 测试工具，Bulkpe 提供了便捷的 Postman 集合以简化请求配置。

1. 导入集合

点击以下链接打开 Bulkpe 的 Postman 集合：Bulkpe Postman 集合。在 Postman 中将其复制到您的工作区。

2. 配置环境变量

在 Postman 中添加环境变量，例如 api_token，以便在请求中引用，无需每次手动输入。

三. 了解 Bulkpe 支付 API

Bulkpe 支付 API 可将资金从 Bulkpe 虚拟账户转至受益人的银行账户或 UPI VPA。

1. API 端点

URL: https://api.bulkpe.in/client/initiatepayout

2. 请求示例

{
  "amount": 1,
  "account_number": "77220101845051",
  "payment_mode": "UPI",
  "reference_id": "Sathya-test6",
  "transcation_note": "Refund03",
  "beneficiaryName": "Sathya Narayanan",
  "ifsc": "FDRL0007777",
  "upi": "aintworried@axl"
}

3. 响应示例

{
  "status": true,
  "statusCode": 200,
  "data": {
    "beneCode": "APIBENEF453",
    "beneName": "Sathya Narayanan",
    "beneAccNum": "77220101845051",
    "beneIfscCode": "FDRL0007777",
    "beneAcType": 10,
    "transcation_id": "TRAREF00034637453",
    "reference_id": "Internal1718712497",
    "amount": 1,
    "payment_remark": "From Pied Piper using Bulkpe - Refund03",
    "payment_mode": "IMPS",
    "status": "PENDING",
    "message": "Transaction Initiated!"
  },
  "message": "Transaction Processing"
}

四. 使用 Postman 发起支付请求

1. 创建请求

在 Postman 中新建一个 POST 请求，URL 为 https://api.bulkpe.in/client/initiatepayout。

2. 设置请求体

在 Body 选项卡中选择 raw，格式为 JSON，输入如下内容：

{
  "amount": 1,
  "account_number": "77220101845051",
  "payment_mode": "UPI",
  "reference_id": "Sathya-test6",
  "transcation_note": "Refund03",
  "beneficiaryName": "Sathya Narayanan",
  "ifsc": "FDRL0007777",
  "upi": "aintworried@axl"
}

3. 添加授权头

Key: Authorization
Value: Bearer {{api_token}}（替换为实际 API 令牌）

4. 发送请求

点击 Send 按钮，即可返回交易响应状态。

5. 示例 API 调用（cURL）

curl --location 'https://api.bulkpe.in/client/initiatepayout' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--data-raw '{
  "amount": 1,
  "payment_mode": "UPI",
  "reference_id": "Internal1714458729",
  "transcation_note": "Payment",
  "upi": "rich@ybl",
  "beneficiaryName": "Richard"
}'

将 YOUR_API_TOKEN 替换为实际 API 令牌。

五. 常见错误及故障排除

在使用 Bulkpe 支付 API 时，可能遇到以下问题：

1. “您无权访问”响应

检查 Authorization 头是否正确传递 Bearer 令牌。
确认 API 令牌是否过期。

2. 请求失败或返回错误代码

验证请求体字段是否完整且正确。
检查网络连接是否正常。

通过以上步骤，您可以顺利集成 Bulkpe 支付 API，并完成首笔支付。如需了解更多高级功能，请参考 Bulkpe 官方文档。

原文链接: https://bulkpe.in/blog/integrating-api-for-payouts