Get Card Transaction Process
GET/openapi/v2/cards/transactions/processRead stored transaction and fee-processing steps for a card owned by the current tenant. This endpoint does not query the service provider, synchronize status, or initiate recovery.
| Item | Value |
|---|---|
| HTTP method | GET |
| Request path | /openapi/v2/cards/transactions/process |
| Request type | query |
Request parameters
| Field | Type | Required | Description |
|---|---|---|---|
cardId | string | Yes | Card ID owned by the current tenant. |
transactionId | string | Yes | items[].id from List Card Transactions: a service-provider transaction ID for purchases, refunds, or voids; a platform order number for recharges or withdrawals. |
transactionType | string | Yes | The row's unified type, case-sensitive: CONSUMPTION, REFUND, VOID, RECHARGE, or WITHDRAWAL. |
The transaction ID, type, and card must match. Transactions from another tenant or card, or missing transactions, cannot be queried. Do not use a raw provider type such as auth as transactionType.
Request example
http
GET /openapi/v2/cards/transactions/process?cardId=card_001&transactionId=TXN_001&transactionType=CONSUMPTIONResponse data
data is an array of processing steps, without pagination:
| Field | Type | Description |
|---|---|---|
[].stepType | string | Step type; see the table below. |
[].stage | string/null | Processing stage or raw business type of this step; meaning varies by step and values may expand. Not the request's unified transaction type. |
[].status | string/null | Status of this step, not the final state of the whole purchase or order; see below. |
[].providerStatus | string/null | Raw service-provider status retained for diagnostics. Use status for business display and decisions. |
[].amount | string/null | Decimal string: absolute amount for transaction and order steps, or the associated fee amount for fee steps. |
[].currency | string/null | Currency of this step's amount. |
[].referenceNo | string/null | Service-provider transaction ID, platform flow number, order number, or fee order number. |
[].occurredAt | string/null | Platform processing time in ISO 8601. Uses processing or completion time, falling back to update or creation time; not the provider's transaction occurrence time. |
[].note | string/null | Additional information; order steps may contain a failure code. |
Step types and statuses
stepType | Meaning | Known status values |
|---|---|---|
CONSUMPTION, REFUND, VOID | Stored purchase, refund, or void record | SUCCESS, FAILED, VOID, PROCESSING; null for historical records without a stored status |
ORDER_FLOW | Recharge or withdrawal order flow | CREATED, PROCESSING, SUCCESS, FAILED |
ORDER_RESULT | Current order result when no flow records exist | CREATED, PROCESSING, SUCCESS, FAILED |
FEE_CHARGE | Fee step, using actual charge status when available | NOT_STARTED, PROCESSING, UNKNOWN, SUCCESS, FAILED; historical fallback to fee-order status may also return CREATED or FROZEN |
Query semantics
- Only stored records are returned. Missing authorization, posting, or refund steps are not reconstructed; webhook receipt and delivery notifications are excluded.
- Multiple refunds with explicit links to the original purchase on the same tenant, card, and service provider are included in its process. Missing or ambiguous relationships are not inferred.
- Sorted by
occurredAtascending, thenreferenceNoascending for equal times; missing timestamps are last. These are platform processing records, not a guarantee of the provider event sequence. - This is the current state of stored records, not an immutable event snapshot. Do not sum step amounts to calculate purchase principal or actual total debit. See List Card Transactions for whole-transaction status and amount definitions.
Response example
A single stored purchase step, for illustration; a complete authorization and posting history is not guaranteed:
json
{
"code": 200,
"msg": "Operation successful",
"data": [
{
"stepType": "CONSUMPTION",
"stage": "auth",
"status": "SUCCESS",
"providerStatus": "succeed",
"amount": "10.5",
"currency": "USD",
"referenceNo": "TXN_001",
"occurredAt": "2026-10-10T02:00:00Z",
"note": null
}
]
}