Get Status

Developing

GET

https://api-dev.asteriatechnology.io/collections/intl-card/status/{txnRef}

4. Get Status

GET /collections/intl-card/status/{txnRef}

Confirms the final outcome. Use this after frictionless success or after validate. Repeat until status is PAID.

Response:

{
  "responseStatus": "SUCCESSFUL",
  "data": {
    "txnRef": "435df745-6a24-4b39-8c81-9f89da1213a0",
    "reference": "INTL-CARD-123456",
    "status": "PAID",
    "collectionStatus": "SUCCESS",
    "amount": "20.00",
    "currency": "USD",
    "csPaymentId": "7906722562756753903814",
    "approvalCode": "541485",
    "nextAction": "DONE"
  }
}

When status is PAID, the merchant USD wallet is credited (minus the configured USD card collection fee).

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-dev.asteriatechnology.io/collections/intl-card/status/c8243a9e-d51e-4fea-b65e-8a4a05676235' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "responseStatus": "SUCCESSFUL",
    "data": {
        "txnRef": "435df745-6a24-4b39-8c81-9f89da1213a0",
        "reference": "INTL-CARD-123456",
        "status": "PAID",
        "collectionStatus": "SUCCESS",
        "amount": "20.00",
        "currency": "USD",
        "csPaymentId": "7906722562756753903814",
        "approvalCode": "541485",
        "nextAction": "DONE"
    }
}

Modified at 2026-10-21 14:45:05

Validate Challenge

Get Bank List

Get Status

4. Get Status#

Request

Responses

4. Get Status