設置Bulkpe賬戶

在開始進行API調用之前，您需要確保擁有一個活躍的Bulkpe賬戶。以下是設置賬戶的基本步驟：

1. 注冊并登錄Bulkpe官網。
2. 在儀表板中獲取您的調用API的關鍵。

導入Bulkpe的Postman集合

Postman是一個常用的API請求。以下是具體操作步驟：

1. 導入Postman集合

   點擊以下鏈接打開Bulkpe的Postman集合：Bulkpe的Postman集合。此鏈接將自動打開Postman，并允許您將集合復制到您的工作區。

2. 配置環境變量

   在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發起支付請求的具體步驟：

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. 添加授權頭

   在Headers選項卡中添加以下內容：

   • Key: Authorization
   • Value: Bearer api_token（將{{api_token}}替換為您的實際API令牌）

4. 發送請求

   點擊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時，您可能會遇到以下問題：

1. 收到“您無權訪問”的響應

   • 檢查Authorization頭是否正確傳遞了Bearer令牌。
   • 確保API令牌未過期。

2. 請求失敗或返回錯誤代碼

   • 驗證請求體中的字段是否完整且正確。
   • 檢查網絡連接是否正常。

通過以上步驟，您已成功集成Bulkpe的支付API并完成了第一筆支付。如果需要更多高級功能或遇到問題，請參考Bulkpe的官方API文檔。

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