List Payments (Transactions)

GET

https://api.crisscross.money/v1/payment

GET

/v1/payment

1 curl -G https://api.crisscross.money/v1/payment \
2      -H "Content-Type: application/json" \
3      -d merchantIds=merchantIds

1 {
2   "transactions": [
3     {
4       "currentState": "completed",
5       "previousStates": [
6         "pending",
7         "processing"
8       ],
9       "processor": "Stripe",
10       "merchantName": "Acme Corp",
11       "transactionId": "txn-9876543210",
12       "amount": 150.75,
13       "transactionType": "sale",
14       "paymentMethodId": "pm_1GqIC8Lz0qyl6XeW",
15       "currency": "USD",
16       "merchantReference": "INV-20240115-001",
17       "transactionStates": [
18         {
19           "state": "pending",
20           "timestamp": "2024-01-15T08:00:00Z",
21           "notes": "Transaction created"
22         },
23         {
24           "state": "processing",
25           "timestamp": "2024-01-15T09:00:00Z",
26           "notes": "Payment processing started"
27         },
28         {
29           "state": "completed",
30           "timestamp": "2024-01-15T09:30:00Z",
31           "notes": "Payment completed successfully"
32         }
33       ],
34       "paymentAttributes": {
35         "customerEmail": "[email protected]",
36         "orderId": "ORD-10001"
37       },
38       "identifiers": {
39         "externalId": "ext-12345"
40       },
41       "paymentInstrument": {
42         "cardType": "Visa",
43         "last4": "4242",
44         "expiryMonth": "12",
45         "expiryYear": "2025"
46       },
47       "processorReference": "ch_1GqIC8Lz0qyl6XeW",
48       "financialTransactionReference": "fin-7890",
49       "currentAttemptId": "att-5555",
50       "batchPayoutId": "batch-202401"
51     },
52     {
53       "currentState": "pending",
54       "previousStates": [],
55       "processor": "PayPal",
56       "merchantName": "Beta LLC",
57       "transactionId": "txn-1234567890",
58       "amount": 89.99,
59       "transactionType": "refund",
60       "paymentMethodId": "pm_2HrJ9bLz0qyl6XeX",
61       "currency": "USD",
62       "merchantReference": "REF-20240114-002",
63       "transactionStates": [
64         {
65           "state": "pending",
66           "timestamp": "2024-01-14T16:45:00Z",
67           "notes": "Refund initiated"
68         }
69       ],
70       "paymentAttributes": {
71         "customerEmail": "[email protected]",
72         "orderId": "ORD-10002"
73       },
74       "identifiers": {
75         "externalId": "ext-67890"
76       },
77       "paymentInstrument": {
78         "cardType": "MasterCard",
79         "last4": "5555",
80         "expiryMonth": "07",
81         "expiryYear": "2024"
82       },
83       "processorReference": "pp_2HrJ9bLz0qyl6XeX",
84       "financialTransactionReference": "fin-1234",
85       "currentAttemptId": "att-6666"
86     }
87   ],
88   "nextCursor": "eyJwYWdlIjoyfQ==",
89   "backCursor": "eyJwYWdlIjowfQ=="
90 }

Lists transactions for one or more merchants using cursor-based pagination. If no cursor is provided, the API returns the first 50 transactions by default.

Query parameters

merchantIdsstringRequired

Comma-separated list of merchant IDs.

cursorstringOptional

Cursor for the next page of results.

backCursorstringOptional

Cursor for the previous page of results.

Response

Transactions retrieved successfully.

transactionslist of objects

nextCursorstring

Cursor for the next page of results (if available).

backCursorstring

Cursor for the previous page of results (if available).

Errors

400

Bad Request Error

401

Unauthorized Error