1. International Cards
Asteria API DOCs
  • Getting Started
  • Webhooks
  • Auth
    • Validate & Generate Access Token
      POST
  • Collections
    • Pay via Bank Transfer
      • Get Banks
      • Generate Dynamic VIrtual Account
      • Check Payment Status
    • Cards
      • Generate Payment Advice
      • Charge Card
      • Check Card Payment Status
    • Mpesa
      • Mpesa API
    • International Cards
      • Setup Card
        POST
      • Check Enrollment
        POST
      • Validate Challenge
        POST
      • Get Status
        GET
  • Payouts
    • Get Bank List
      GET
    • Validate Account
      POST
    • Initiate Transfer
      POST
    • Check Payout Status
      POST
  • Account
    • Get Wallet Balance
      GET
  1. International Cards

Validate Challenge

Developing
POST
https://api-dev.asteriatechnology.io/collections/intl-card/validate

3. Validate Challenge#

POST /collections/intl-card/validate
Only if enrollment returned CHALLENGE_REQUIRED, after the challenge iframe completes.
Request:
{
  "txnRef": "b99e4c10-7ec6-4a24-8826-f39cc7f041f1"
}
Response:
{
  "responseStatus": "SUCCESSFUL",
  "data": {
    "txnRef": "b99e4c10-7ec6-4a24-8826-f39cc7f041f1",
    "status": "AUTHORIZED",
    "csPaymentId": "7906730242056000403813",
    "approvalCode": "972480",
    "nextAction": "CONFIRM_STATUS"
  }
}

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api-dev.asteriatechnology.io/collections/intl-card/validate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "txnRef": "c8243a9e-d51e-4fea-b65e-8a4a05676235"
}'
Response Response Example
{}
Modified at 2026-10-21 14:42:30
Previous
Check Enrollment
Next
Get Status
Built with