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

高效管理支付款项对处理金融交易的任何企业都至关重要。无论是发放工资、支付供应商款项还是处理退款，Bulkpe都提供了强大的API来无缝管理这些交易。本文将详细介绍如何集成Bulkpe的支付API，包括如何使用Postman工具和提供的集合来授权请求并发起支付。

设置Bulkpe账户

在开始进行API调用之前，您需要确保拥有一个活跃的Bulkpe账户。以下是设置账户的基本步骤：

注册并登录Bulkpe官网。
在仪表板中获取您的调用API的关键。

导入Bulkpe的Postman集合

Postman是一个常用的API请求。以下是具体操作步骤：

导入Postman集合

点击以下链接打开Bulkpe的Postman集合：Bulkpe的Postman集合。此链接将自动打开Postman，并允许您将集合复制到您的工作区。
配置环境变量

在Postman中设置环境变量，例如api_token，以便后续请求中可以直接引用。

了解Bulkpe支付API

Bulkpe的支付API支持从Bulkpe虚拟账户向受益人的银行账户或UPI VPA转账。以下是API的基本信息和示例：

API端点

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

请求示例

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

响应示例

成功的请求将返回一个包含交易详情的JSON响应，例如：

{
  "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发起支付请求

以下是通过Postman发起支付请求的具体步骤：

创建请求

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

设置请求体

在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"
}

添加授权头

在Headers选项卡中添加以下内容：
- Key: Authorization
- Value: Bearer api_token（将{{api_token}}替换为您的实际API令牌）
发送请求

点击Send按钮，Postman将返回响应数据，显示交易状态。

示例API调用（使用cURL）

以下是一个使用cURL的API调用示例：

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替换为您在Bulkpe仪表板中获取的实际API令牌。

常见错误及故障排除

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

收到“您无权访问”的响应
- 检查Authorization头是否正确传递了Bearer令牌。
- 确保API令牌未过期。
请求失败或返回错误代码
- 验证请求体中的字段是否完整且正确。
- 检查网络连接是否正常。

通过以上步骤，您已成功集成Bulkpe的支付API并完成了第一笔支付。如果需要更多高级功能或遇到问题，请参考Bulkpe的官方API文档。

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