Skip to main content

Statuses

Overview​

Celar provides endpoints to check the status of individual payments, list all payments and generate summaries. These APIs are useful for reconciliation and reporting.

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>'

Example 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>'

Example response:

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