REST API endpoints for transactions

Reference for PIK transactions API: GET /transactions to list payment records, and GET /transactions/ to retrieve a single transaction.

The transactions endpoints let you query payment records associated with your payment links. Each transaction represents a payment attempt made by a customer via a payment link.

List transactions

GET /transactions

Returns a paginated list of all transactions in your account.

Query parameters

status · string

Filter by status: pending, confirmed, settled, failed

payment_link_id · string

Filter transactions by a specific payment link ID.

currency · string

Filter by digital asset code. Example: USDT

from · string

Start of date range filter (ISO 8601). Example: 2024-01-01T00:00:00Z

to · string

End of date range filter (ISO 8601). Example: 2024-01-31T23:59:59Z

limit · integer

Number of results per page. Default: 20. Max: 100

offset · integer

Number of results to skip. Default: 0

Example request

curl -X GET "https://api.pik.global/v1/transactions?status=confirmed&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response 200 OK

{
  "data": [
    {
      "id": "txn_def456",
      "payment_link_id": "pl_abc123xyz",
      "amount": "75.00",
      "currency": "USDT",
      "status": "confirmed",
      "created_at": "2024-01-15T10:40:00Z",
      "confirmed_at": "2024-01-15T10:45:00Z"
    }
  ],
  "total": 1,
  "limit": 10,
  "offset": 0
}

---

Retrieve a transaction

GET /transactions/{id}

Returns a single transaction by its ID.

Path parameters

id · string · required

The transaction ID. Example: txn_def456

Example request

curl -X GET https://api.pik.global/v1/transactions/txn_def456 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response 200 OK

{
  "id": "txn_def456",
  "payment_link_id": "pl_abc123xyz",
  "amount": "75.00",
  "currency": "USDT",
  "status": "settled",
  "tx_hash": "0xabc123def456...",
  "created_at": "2024-01-15T10:40:00Z",
  "confirmed_at": "2024-01-15T10:45:00Z",
  "settled_at": "2024-01-15T11:00:00Z"
}

Response fields

id · string

Unique transaction ID. Prefix: txn_

payment_link_id · string

The ID of the payment link this transaction is associated with.

amount · string

Payment amount as a decimal string.

currency · string

Digital asset code.

status · string

Transaction status: pending, confirmed, settled, or failed.

tx_hash · string

On-chain transaction hash. Present once the transaction is confirmed.

created_at · string

ISO 8601 timestamp when the transaction was initiated.

confirmed_at · string

ISO 8601 timestamp when the transaction was confirmed on-chain. null if not yet confirmed.

settled_at · string

ISO 8601 timestamp when the funds were credited to your balance. null if not yet settled.

Transaction statuses

Status	Description
pending	Payment initiated but not yet confirmed on-chain
confirmed	Confirmed on the blockchain
settled	Funds credited to your PIK balance
failed	Payment failed or timed out

Error responses

Status	Code	Description
404	not_found	No transaction found with the given ID