Endpoint:
Method: GET
Type:
URL: {{API_BASE_URL}}v2/cards/transactions
Request Parameter:
| Parameter | Required | Type | Description |
|---|---|---|---|
| start_timestamp | Y | integer | start time of transactions (unix timestamp) |
| end_timestamp | Y | integer | end time of transactions (unix timestamp, max 31 days range) |
| card_number | N | string | card number, Multiple card numbers separate with comma |
| alias | N | string | alias of card_number |
| status | N | string | Status: [approved, declined] |
| card_bin_code | N | string | the code of card bin, multiple values are separated by commas(e.g: pg3g5FFF,9iqCGfxx), you can get the card bin code by api /cards/cardbins |
| tags | N | string | card tag, multiple values are separated by commas(e.g: test_tag,test_tag2), you can get the card tag by api /cards |
| page | N | integer | page |
| per_page | N | integer | page size (max 200) |
Example request:
GET {{API_BASE_URL}}/v2/cards/transactions?start_timestamp=1643644800&end_timestamp=1644508799&status=approved&per_page=50
Response
| Parameter | Type | Description |
|---|---|---|
| data | object | data |
| id | integer | transaction id |
| card_number | string | card_number |
| alias | string | card alias name |
| username | string | username of card owner |
| merchant_name | string | merchant_name |
| transaction_amount | float | transaction amount |
| transaction_currency | string | transaction currency |
| transaction_country | string | transaction_country |
| billing_amount | float | billing_amount |
| billing_currency | string | billing_currency |
| status | string | status: [approved, declined] |
| fail_reason | string | fail_reason |
| transaction_type | string | transaction_type: [authorization, reversal] |
| transaction_unix_timestamp | integer | authorization_unix_timestamp |
| billing_status | enum | billing_status: [pending, released, processed, declined, void] |
| meta | object | meta |
| pagination | object | pagination |
| total | number | total |
| count | number | count |
| per_page | number | per_page |
| current_page | number | current_page |
| total_pages | number | total_pages |
| links | object | links |
Status: 200
Status: 422 (Validation Error)
{
"data": [
{
"id": 6,
"transaction_unix_timestamp": 1644508800,
"card_number": "5329593610000000",
"alias": "test",
"username": "tom",
"merchant_name": "FACEBK ZR6GW8XXXX fb.me/ads IRL",
"billing_amount": 900.00,
"billing_currency": "USD",
"status": "approved",
"transaction_type": "authorization",
"fail_reason": "Approved or completed successfully/Approval",
"billing_status": "processed",
"transaction_amount": 900.00,
"transaction_currency": "USD",
"transaction_country": "US"
}
],
"meta": {
"pagination": {
"total": 1,
"count": 1,
"per_page": 15,
"current_page": 1,
"total_pages": 1,
"links": {}
}
}
}