Presentation logo

Reject Payout Request Recommended


Reject Payout can be used to reject the payout request, that was originally submitted by the customer within the Cashier. Reject Payout is the API analogue of the payout rejection routine within Backoffice.

REQUEST PARAMETERS

Variable Type Description
merchant_id varchar(50) Required. Merchant API client account identifier
ext_payout_id varchar(50) Required. Payout request identifier (received in CreatePayout response)
frontend varchar(256) Required. Frontend in which the payout has been requested and will be processed
timestamp int(11) Required. Request time. URL will be active during 1 min after this time
version varchar(10) Required. API version
signature varchar(96) Required. Required. sha256-encoded representation of the concatenation of request parameters and secret

RESPONSE PARAMETERS

Variable Type Description
status int Required.
- 0 if the request was successful
- Negative integer if internal server/network error occurs
- Positive integer if application/logical error occurs
description varchar(256) Required. Accurate description of the result. Return the actual error for any exception as it helps to diagnose issues in production
version varchar(3) Required. API version
signature varchar(96) Required. sha384 HASH code of response (same as in request)

EXAMPLE

Request

For example below: Merchant Secret = "MerchantSecretKey"

curl -X POST \
  https://gateway.praxispay.com/api/rejectpayout \
  -H 'Content-Type: application/json' \
  -H 'cache-control: no-cache' \
  -d '{"ext_payout_id":"752856",
  "merchant_id":"Test-Integration-Merchant",
  "frontend":"Integration TEST USD",
  "timestamp":1559825373, 
  "version":"1.1",
  "signature":"db65d6b930176ffc8f020bd1ea05f593792c06a6df564d07cae1bd529210ddcf5bfaae8a172168502d0fc1d390708bd1"}'

Response (OK)

{
    "description": "Transaction rejected successfully: ExtPayoutID=752856",
    "status": 0,
    "version": "1.1",
    "signature": "7fe49a061cec8d0ff01fe422d6ce1209a13523b75249f312d6e759bad4e6ddbd4514df79571d08ffd0636d2b9ac4b319"
}

Response (ERR)

{
    "description": "Transaction not found: ExtPayoutID=752856",
    "status": 1,
    "version": "1.1",
    "signature": "c9885a088a69d5eb2828c49564456e2b6f483a6e8b2969a56996a759d142fdbaec463c405c90fa5a6ee252de74177b93"
}

Please refer to How to Build Signature for details on signing the request.