Retrieving Payout Data

Authenticating the Request

To successfully retrieve payout data, it is essential to authenticate the request using an OAuth token of type client_credentials. You should generate this token using the configuration keys specific to the Point of Sale (POS) associated with the Shop from which you intend to retrieve data.

Retrieving Payout Data

To retrieve data for a specific payout, you can send an HTTP GET request to the /api/v2_1/payouts/{payoutId} endpoint, where payoutId represents the unique identifier for the payout. This payoutId will be returned in the response to the payout creation request, allowing you to access the detailed information associated with that particular payout.

Notes

Retrieving payout data is limited to the last 2 weeks.

Retrieving Payout Request Example

curl -X GET https://secure.payu.com/api/v2_1/payouts/133bfe5f400e4b2c8da44abfdf753d79
-H "Content-Type: application/json"
-H "Authorization: Bearer 3e5cac39-7e38-4139-8fd6-30adc06a61bd"

Successful Request Response Example

{
    "payout": {
        "payoutId": "133bfe5f400e4b2c8da44abfdf753d79",
        "amount": "1100",
        "description": "Billing: 169602484",
        "status": "PENDING"
    },
    "status": {
        "statusCode": "SUCCESS"
    }
}

Failed Request Response Example

{
    "status": {
        "statusCode": "DATA_NOT_FOUND",
        "severity": "ERROR",
        "code": "8354",
        "codeLiteral": "INCORRECT_MERCHANT_POS",
        "statusDesc": "INCORRECT_MERCHANT_POS"
    }
}

For details on the parameters and their specific usage when retrieving a payout, you can refer to the Retrieve a Payout section in our API Reference.