Flash ProtocolFLASH PROTOCOL
DOCUMENTATION

Transactions

Retrieve and reconcile payments.

List Transactions

Fetch a paginated list of transactions across all your payment links.

GET/api/v1/transactions

Query Parameters

Parameter
Required
Description
limit
No
Items per page (default: 10, max: 100).
offset
No
Pagination offset (default: 0).
status
No
Filter by status (e.g. "completed").
payment_link_id
No
Filter by a specific payment link.

Request Example

curl -X GET "https://flash-protocol.vercel.app/api/v1/transactions?limit=10&status=completed" \
  -H "Authorization: Bearer pg_live_8cd80b..."
200 OK
{
  "data": [
    {
      "id": "tx_987654321",
      "payment_link_id": "pl_abc123",
      "status": "completed",
      "customer_wallet": "0x123...abc",
      "source_chain_id": 1,
      "source_token_symbol": "ETH",
      "source_amount": "0.015",
      "actual_output": "49.99",
      "source_tx_hash": "0xdef...",
      "completed_at": "2024-03-20T14:05:00Z",
      "created_at": "2024-03-20T14:04:30Z"
    }
  ],
  "count": 1,
  "limit": 10,
  "offset": 0
}

Get Transaction by ID

Retrieve full details for a single transaction. Use this to verify payment status before fulfilling orders.

GET/api/v1/transactions/:id
curl -X GET https://flash-protocol.vercel.app/api/v1/transactions/tx_987654321 \
  -H "Authorization: Bearer pg_live_8cd80b..."
200 OK
{
  "id": "tx_987654321",
  "payment_link_id": "pl_abc123",
  "status": "completed",
  "customer_wallet": "0x123...abc",
  "source_chain_id": 1,
  "source_token_symbol": "ETH",
  "source_amount": "0.015",
  "actual_output": "49.99",
  "destination_chain_id": 8453,
  "destination_token_symbol": "USDC",
  "source_tx_hash": "0xdef...",
  "destination_tx_hash": "0xaaa...",
  "completed_at": "2024-03-20T14:05:00Z",
  "created_at": "2024-03-20T14:04:30Z"
}

Transaction Statuses

pendingprocessingcompletedfailedexpired

Error Responses

Status
Code
Description
401
Unauthorized
Invalid or missing API key.
403
Forbidden
Transaction belongs to another merchant.
404
Not Found
Transaction ID does not exist.