💻
Payouts Integration
  • Introduction
  • Functional overview
  • Onboarding
  • Postman Collection
  • Authentication
  • Authentication Token
    • API to Generate Token using username/password
    • API to Generate Token using private client id
  • Refresh Tokens
    • Refresh Token API
  • IP Check
  • API Integration
  • Testing Credentials
  • API Flow Diagram
  • Beneficiary Management
    • View Beneficiary Detail
    • Beneficiary Creation / Registration
  • Core Payouts API
    • Get Account Details API
    • Cancel Transfer API
    • Check Transfer Status API
    • Initiate/Schedule Transfer API
  • Verification
    • Verify Account / Penny Test
    • Validate Vpa
    • IFSC Details
  • smart send
    • Feature
    • Smart Send API
      • Cancel Smart Send
      • Smart Send Status
    • Smart Send V2 API
      • Create Smart Send Link
      • Smart Send Status
      • Cancel Smart Send
      • Extend Expiry Date
    • Bulk Smart Send
      • Bulk File Upload
      • Bulk Process File
    • Smart Send Error Codes
    • Fetch masked Vpas
  • Webhooks
    • What are Webhooks?
    • Default Webhooks
    • Creating Webhooks
    • Set Webhook API
    • Types of webhooks
  • Settings
    • Disable queued Payout
  • FAQ
Powered by GitBook
On this page
  • Request Header Params
  • Request Params
  • Example

Was this helpful?

  1. Core Payouts API

Cancel Transfer API

merchant can cancel queued transfer by calling this api.

PreviousGet Account Details APINextCheck Transfer Status API

Last updated 4 years ago

Was this helpful?

Request Header Params

Key

Description

Data type

Mandatory

possible Values

Authorization

Access token generated earlier.

String

Yes

Bearer {access_token}

payoutMerchantId

This is the merchant id provided while onboarding

String

Yes

payountMerchantId is different from payumoney merchant id, please check payouts dashboard or call customer support if you don’t know your payoutsMerchantID

Request Params

Key

Description

Data type

Mandatory

possible Values

merchantRefId

Unique reference id generated at merchant side to distinguish between multiple transfers. Same value will be used by merchant to check status of transfer or to cancel it.

String

Yes

Example

Sample Request :

curl -X POST \
 https://test.payumoney.com/payout/payment/cancel \
 -H 'authorization: bearer 45f87fed35bdafe9f47698ed03e202e282f873b79a57eb53a9d30247b376f01d' \
 -H 'content-type: application/x-www-form-urlencoded' \
 -H 'payoutmerchantid: 1111122' \
 -d merchantRefId=1584856958885

Response :

{
 "status": 0,
 "msg": "Payout transaction cancelled",
 "code": null,
 "data": null
 }
{
 "status": 1,
 "msg": "Merchant reference Id is incorrect",
 "code": null,
 "data": null
 }

https://payout.payumoney.com/payout/payment/cancel
https://test.payumoney.com/payout/payment/cancel