Payment History

Query merchant payment history. Requires API Key authentication.

REST API

# Query by orderId
curl "https://gateway.dev.solonetwork.io/api/v1/merchant/payments?orderId=order-001" \
  -H "x-api-key: sk_xxxxx"

# Query by paymentId
curl "https://gateway.dev.solonetwork.io/api/v1/merchant/payments/0xabc123..." \
  -H "x-api-key: sk_xxxxx"

Response

{
  "success": true,
  "data": {
    "paymentId": "0xabc123...",
    "orderId": "order-001",
    "status": "PAID",
    "amount": "10500000000000000000",
    "tokenSymbol": "SUT",
    "tokenDecimals": 18,
    "txHash": "0xdef789...",
    "payerAddress": "0x1234...",
    "createdAt": "2024-01-26T12:30:00Z",
    "confirmedAt": "2024-01-26T12:35:42Z",
    "expiresAt": "2024-01-26T12:35:00Z"
  }
}

Response Fields

Field	Type	Description
paymentId	string	Unique payment identifier (bytes32 hash)
orderId	string	Merchant order ID
status	string	CREATED, PAID, REFUND_SUBMITTED, REFUNDED, INVALID, EXPIRED, FAILED
amount	string	Amount in wei
tokenSymbol	string	Token symbol
tokenDecimals	number	Token decimals
txHash	string	On-chain transaction hash (present after confirmation)
payerAddress	string	Payer wallet address (present after confirmation)
confirmedAt	string	Payment confirmation timestamp
expiresAt	string	Payment expiry timestamp

Next Steps

• Error Codes - Error handling