Quick Start

The minimal path: authenticate, check a transaction status, handle the result.

#1. Authenticate

curl -X POST https://sandbox.api.exirom.com/api/api/v1/auth \
  -H "Content-Type: application/json" \
  -d '{ "apiKey": "YOUR_API_KEY" }'

{ "token": "eyJhbGci..." }

#2. Check transaction status

curl https://sandbox.api.exirom.com/api/api/v1/payments/card/status/{transactionId} \
  -H "Authorization: Bearer eyJhbGci..."

{
  "transactionId": "txn_abc123",
  "transactionStatus": "FAILED",
  "declineCode": 1
}

#3. Handle the result

Key rule: HTTP 200 does not mean success. A declined payment returns 200 with transactionStatus: "FAILED". Always check transactionStatus.

#Next steps

• Transaction Lifecycle Flow — full state machine
• Error Handling — HTTP errors and payment-level failures
• Decline Codes Reference — complete decline code table