Skip to main content
POST
/
payment_status
Check payment completion
curl --request POST \
  --url https://ringup.dev/api/tools/payment_status \
  --header 'X-Caller-Number: <x-caller-number>' \
  --header 'X-Ringup-Merchant: <x-ringup-merchant>'
{
  "status": "pending"
}

Headers

​
X-Caller-Number
string
required

The caller's phone number in E.164, templated from the platform's caller-ID variable. Never model-generated.

Example:

"+14155550142"

​
X-Ringup-Merchant
string
required

The dialed number in E.164 (resolved to a merchant server-side) or an explicit merchant id.

Example:

"tonys-pizza"

​
X-Call-Id
string

The platform's call id. Used for charge idempotency: retries within a call can never double-charge.

Response

200 - application/json

The current payment state for this call.

​
status
enum<string>
Available options:
paid,
pending