Payout staus by Merch ID | API PayStar.uk

INFO

This method is used to check the status of a payout and is applicable if you created the payment using one of the following method:

Payout | H2H

When checking the status, provide the externalTransactionId that you send in the payout creation request.

If you receive an error or a non-final status, repeat the status check every 5 minutes until you receive a final status.

Additionally, please refer to the Callbacks section, which allows you to receive the payment status via callbacks.

We recommend using both approaches — callbacks and the status check method — to ensure a more reliable integration.

Payment Statuses

Created – The payment has been successfully created but processing has not yet started.

Processing – The payment is currently being processed.

Success – The payment has been successfully completed.

Failed – The payment was declined.

Check status payout order

Polling - every 2 min before getting the final status.

CURL Example | GET Status payout order

curl --request GET \
 --url secure.PayStar.uk/api/v1/integration/withdrawal-order/{externalTransactionId}/status-by-external-transaction-id \
 --header 'Authorization: Bearer YOUR TOKEN' \ 
 --header 'Content-Type: application/json' \

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Example

{
    "externalId": "f8832bdf-ce98-48e1-b3d3-023fdb7358d0",
    "orderStatus": "Processing",
    "orderHistory": [
        {
            "time": "2025-07-28T09:29:51.339832",
            "action": "4.1.0.0"
        }
    ]
}

🟠401Unauthorized

🟠403Forbidden

🟠404Order Not Found

🔴500Internal Server Error: Errors 499+ occur in unforeseen circumstances. They are transient and not indicative of the order status. If you receive a 499+ error when creating a payment, we recommend checking the payment status using the following method: **/a

Payout status H2H - Merch ID

Check status payout order#

CURL Example | GET Status payout order#

Request

Request Code Samples

Responses

Check status payout order

CURL Example | GET Status payout order