Statuses

Celar provides endpoints to check payment status, list all payments and generate summaries.

1. Retrieve Payment or Batch Status

Check the latest status for a specific payment_id or batch_id.

curl --request GET \
  --url https://api.sandbox.celar.io/api/v1/payments/<payment_id>/status \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <<your_api_key>>'

Response

{
  "payment_id": "pay_100521dccb3f9ad0",
  "status": "settled"
}

2. List All Payments

Retrieve a list of all payments. Supports filters:

• customer_id
• payment_id
• status
• limit
• offset

curl --request GET \
  --url https://api.sandbox.celar.io/api/v1/payments \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <<your_api_key>>'

3. Get Payment Summary

Retrieve aggregated statistics for all payments under your organization.

curl --request GET \
  --url https://api.sandbox.celar.io/api/v1/payments/summary \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <<your_api_key>>'

Response

{
  "total_payments": 320,
  "total_volume": "158,000.00 USDC",
  "successful": 310,
  "failed": 10
}