Dashboard

Bulkpe Payouts

Initiate Payout

Use this API to initiate an amount transfer from your Bulkpe Virtual Account / Current Account / Escrow Account to a beneficiary bank account or UPI VPA.

POSThttps://api.bulkpe.in/client/initiatepayout

Send your API key as Authorization: Bearer <key>. See Authorization.

When a payout is initiated, Bulkpe processes it with the partner bank.

  • If the bank completes the transaction instantly, you’ll get the final status (SUCCESS or FAILED) in the sync response.
  • If the response shows PENDING, you’ll later receive a callback from Bulkpe once the status updates (e.g., PENDING → SUCCESSor FAILED). To set up callback, refer to this page.
  • If the payout fails, refer to the message field for the reason and retry if needed.
  • You can also use the Fetch Transaction Status API anytime to check the current status of the payout.
  • For more details around key things to handle, refer to this page.

Request

Body

  • amountnumberMandatory

    Amount to send, in rupees. Must be within the limits of the chosen payment_mode.

    Example 1

  • account_numberstringConditional

    Beneficiary bank account number. Required for IMPS, NEFT and RTGS; not needed for UPI.

    Example 77220000000001

  • payment_modestringMandatory

    Rail to send the payout on: IMPS, NEFT, RTGS or UPI.

    Example UPI

  • reference_idstringMandatory

    Your unique ID for this payout. Used to match callbacks and check status.

    Example Payout-test6

  • transaction_notestringOptional

    Short remark added to the payment, shown in the beneficiary’s statement.

    Example Refund03

  • beneficiaryNamestringMandatory

    Name of the beneficiary account holder.

    Example Your Beneficiary Name

  • ifscstringConditional

    IFSC of the beneficiary’s bank branch. Required for IMPS, NEFT and RTGS; not needed for UPI.

    Example FDRL0007777

  • upistringConditional

    Beneficiary UPI ID. Required only when payment_mode is UPI.

    Example dummyUPI@yesbank

  • contact_idstringOptional

    Saved contact to pay. Use it instead of passing bank or UPI details each time.

Response

Fields inside data. Full examples are in the response panel.

  • beneCodestring
  • beneNamestring

    Example name

  • beneAccNumstring

    Example 77220000000001

  • beneIfscCodestring

    Example FDRL0007777

  • beneAcTypenumber

    Example 10

  • transaction_idstring

    Example TRAREF00034637453

  • reference_idstring

    Example Internal1718712497

  • amountnumber

    Example 1

  • payment_remarkstring

    Example From Peid Piper using Bulkpe - Refund03

  • payment_modestring

    Example IMPS

  • statusstring

    Example PENDING

  • utrstring
  • messagestring

    Example Transaction Initiated!


Payment Method Limits

Payment MethodMinimum AmountMaximum AmountDay / Month Limit
IMPS1500000No Limit
NEFT1No LimitNo Limit
RTGS200000No LimitNo Limit
UPI1100000No Limit

There is no daily or monthly limit on number of payouts.