Search Payments by Merchant Reference

curl -G https://api.crisscross.money/v1/payment/search \
     -d merchantIds=merchantIds \
     -d merchantReference=merchantReference

1	[
2	{
3	"currentState": "completed",
4	"previousStates": [
5	"pending",
6	"processing"
7	],
8	"processor": "Stripe",
9	"merchantName": "Acme Corp",
10	"transactionId": "txn_1GqIC8Lz0qyl6XeWz5a1b2c3",
11	"amount": 149.99,
12	"transactionType": "sale",
13	"paymentMethodId": "pm_1GqIC7Lz0qyl6XeWz4b1a2c3",
14	"currency": "USD",
15	"merchantReference": "INV-20240615-00123",
16	"transactionStates": [
17	{
18	"state": "pending",
19	"timestamp": "2024-06-15T10:00:00Z",
20	"details": "Transaction created"
21	},
22	{
23	"state": "processing",
24	"timestamp": "2024-06-15T10:05:00Z",
25	"details": "Payment processing started"
26	},
27	{
28	"state": "completed",
29	"timestamp": "2024-06-15T10:10:00Z",
30	"details": "Payment completed successfully"
31	}
32	],
33	"paymentAttributes": {
34	"customerEmail": "[email protected]",
35	"orderId": "ORD-987654321"
36	},
37	"identifiers": {
38	"invoiceId": "INV-20240615-00123",
39	"customerId": "cust_123456789"
40	},
41	"paymentInstrument": {
42	"cardType": "Visa",
43	"last4": "4242",
44	"expiryMonth": "12",
45	"expiryYear": "2026",
46	"cardholderName": "John Doe"
47	},
48	"processorReference": "ch_1GqIC8Lz0qyl6XeWz5a1b2c3",
49	"financialTransactionReference": "FTX-20240615-7890",
50	"currentAttemptId": "att_1GqIC8Lz0qyl6XeWz5a1b2c3",
51	"batchPayoutId": "batch_20240615_01"
52	}
53	]

Search for payments using a merchant reference. Returns matching transactions across the specified merchant IDs.

Query parameters

merchantIdsstringRequired

Comma-separated list of merchant IDs (UUIDs) to search within.

merchantReferencestringRequired

The merchant reference to search for.

Response

Matching transactions returned successfully.

currentStatestring

Current transaction state

previousStateslist of strings

Array of previous transaction states

processorstring

Payment processor used for the transaction

merchantNamestring

Merchant name

transactionIdstring

Unique transaction identifier

amountdouble

Transaction amount

transactionTypestring

Transaction type

paymentMethodIdstring

Payment method identifier

currencystring

Transaction currency

merchantReferencestring

Merchant reference

transactionStateslist of maps from strings to any

Detailed transaction state history

paymentAttributesmap from strings to strings

Payment-specific attributes and metadata

identifiersmap from strings to strings

Additional transaction identifiers

paymentInstrumentmap from strings to any

Payment instrument details when applicable.

processorReferencestring

Payment processor reference

financialTransactionReferencestring

Financial transaction reference from the processor

currentAttemptIdstring

Current attempt identifier

batchPayoutIdstring

Batch payout identifier, if the transaction is part of a batch payout

Errors

401

Unauthorized Error

422

Unprocessable Entity Error