Which API do I need?#
Povito's two public APIs serve different jobs and do not overlap. The Partner API connects a Povito seller's own systems — ERP, POS, inventory — to their catalog, stock, prices and orders on Povito. The Checkout API takes payments: your server creates a checkout session and the shopper pays on Povito's hosted page.
By what you are building#
| You are building | Use | Start at |
|---|---|---|
| A sync that creates or updates a seller's products from their ERP, POS or inventory system | Partner API | Products |
| A scheduled stock-level and price sync for SKUs a seller already sells on Povito | Partner API | Inventory |
| Recording stock that changed outside Povito — a shop-floor sale, breakage, a restock — with a reason | Partner API | Stock adjustments |
| Pulling a seller's Povito orders, line items and what they will be paid into their own system | Partner API | Orders |
| A payment step for a store or app: the shopper verifies their phone and pays with ZainCash, FIB, a card or cash on delivery on a hosted page | Checkout API | Quickstart |
| Refunding a payment taken through Povito Checkout | Checkout API | Refunds |
| Being told when a payment completes | Checkout API | Webhooks |
| Being told when a seller receives an order | Partner API — there is no order push yet; poll GET /orders with since |
Orders |
| Accepting, shipping or cancelling an order | Neither — that happens in the Seller dashboard |
If you are building both a seller integration and a payment integration, they are two separate integrations with two different keys from two different issuers.
The two APIs at a glance#
| Partner API | Checkout API | |
|---|---|---|
| For | A Povito seller's own systems | Taking payments through Povito Checkout |
| Key issued by | The seller, in the Seller dashboard → Settings → Integrations | Povito, to the merchant |
| Keys | povito_sk_test_… / povito_sk_live_… |
secret povito_ck_…, publishable povito_pk_… (each test or live) |
| Sandbox | https://api-staging.povito.com/partner/v1 |
https://api.checkout.staging.povito.com/v1 |
| Live | https://api.povito.com/partner/v1 |
https://api.checkout.povito.com/v1 |
| What makes a call a test | The environment: test keys work only in the Sandbox |
The key: a test key is in test mode on either host |
| Money | Whole Iraqi dinars — 25000 is 25,000 IQD |
Integer minor units of the currency — IQD has none, USD is cents |
| Keyed by | Your own SKUs (external_sku) |
Your own reference_id per order attempt |
| Idempotency | Idempotency-Key required on all three write routes; a repeat with the same body replays the stored response for 24 hours |
Idempotency-Key required on creates; a repeat replays the stored response for 24 hours |
| Push notifications | Not yet — poll | Signed webhooks |
| Reference | Partner API reference | Checkout API reference |
The environment and key rules are the part most worth reading before you write code: Keys and environments.
Who Povito Checkout serves today
Povito Checkout currently serves Povito's own storefronts. Offering it to third-party merchants is a regulated activity in Iraq and waits on a licensing decision — see Legal.