No momento, esta página não está disponível em português
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