Skip to main content
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

StatusDescription
pendingPayment initiated but not yet confirmed on-chain
confirmedConfirmed on the blockchain
settledFunds credited to your PIK balance
failedPayment failed or timed out
Error responses
StatusCodeDescription
404not_foundNo transaction found with the given ID