Synchronize payment status with the provider

get/payment/{service}/v1/tenants/{tenant_id}/payments/{payment_id}

Requires an API key

The tenant's single payment read. Adds processor_reference and the checkout customer_email, which no other response carries.

Path parameters

tenant_idintegerRequired
servicestringRequired
payment_idstringRequired

Returns · 200

idstringRequired
bill_idstringRequired
tenant_idintegerRequired
servicestringRequired
statusenumRequired
One of preparing, pending, authorized, captured, canceled, refund_pending, refund_failed, refunded
hold_minorintegerRequired
captured_minorintegerRequired
refunded_minorintegerRequired
currencystring
Default "USD"
payment_modeenumRequired
live only for a Stripe payment taken in live mode on a connected account, as the provider recorded it at authorization; test otherwise.
One of test, live
authorized_atstring (date-time) | null
When Stripe authorized the hold (the Charge's creation time); null before authorization and for the simulator.
next_actionobject | nullRequired
processor_referencestring | null
The processor's payment reference (a Stripe PaymentIntent ID), for reconciliation in its dashboard.
customer_emailstring | null
The email the driver entered at hosted checkout, for receipts. Personal data: store and show it only to this tenant.

Errors

401 Unauthorized 403 Forbidden 404 Not found 409 Conflict 422 Invalid request 429 Rate limited 502 Upstream error 503 Unavailable

GET /payment/{service}/v1/tenants/{tenant_id}/payments/{payment_id}

curl --fail-with-body "https://api.ivoracharge.com/payment/simulator/v1/tenants/1042/payments/payment_0123456789abcdef" \
  -H "Authorization: Bearer $IVORA_API_KEY"

Response · 200

{
  "id": "id_0123456789abcdef",
  "bill_id": "bill_0123456789abcdef",
  "tenant_id": 1042,
  "service": "simulator",
  "status": "preparing",
  "hold_minor": 1250,
  "captured_minor": 1250,
  "refunded_minor": 1250,
  "currency": "USD",
  "payment_mode": "test",
  "authorized_at": "2026-09-30T17:00:00Z",
  "next_action": {},
  "processor_reference": "string",
  "customer_email": "string"
}

Try it is not available here yetRequests from this page are off until the production API at https://api.ivoracharge.com is public. Use the code samples from your application server; Ivora grants production access. Keys are created in Developer tools.