Default icon

Get payout status

Get the actual payout state at merchant level.

If there are any pending changes for the specified payout, the /getPayoutStatus response returns the following:

  • The original status of the payout. For example, the previous status before the payout was set to pending. 
  • The new status requested for the payout. This is the status that is waiting for approval or rejection.

Request parameters

To obtain payout status information for a merchant, make a POST /getPayoutStatus request specifying:

NameTypeRequiredDescription

merchantCode

String

-white_check_mark-

A merchant code string holds a value to identify a merchant.

Format:

  • Either: MerchantAccount.Merchant_Code
  • Or: Merchant_Code

Response parameters

The response contains the following information:

NameTypeReturned by defaultDescription

actualState

String

-white_check_mark-

The actual status of the payout.
Allowed values:

  • Blocked

  • Unblocked

status

String

-white_check_mark-

The original status of the payout, i.e. preceding the pending status.
Allowed values:

  • NonPayable (This is always the initial status)

  • Payable

  • Blocked

pendingNewStatus

String

-x-

The payout status change that has been requested, and that is waiting for approval or rejection while the payout is pending.
Allowed values:

  • Payable

  • Blocked

When a payout is pending, it is considered blocked.

jaasUserKey

String

-x-

String representation of the account user name used to modify the status.

note

String

-x-
When a payout is set to Blocked, you can add an explanatory note.
If it is populated, the corresponding content is returned here. 

pspReference

String

-white_check_mark-

A reference to uniquely identify the request.

warnings

String

-x-

List containing one or more warning messages.
Returned when the request is not correctly processed.

errors

String

-x-

List containing one or more error messages.
Returned when the request fails.

Examples

Request

Response