Quickstart
Create and verify your first test payment.
1. Get a test key
Open your payment workspace, choose API Keys, then create a Sandbox key with payments:write and payments:read.
2. Create a payment
curl --fail-with-body "$EKMIVO_API_ORIGIN/v1/payment/create" \
-H "Authorization: Bearer $EKMIVO_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-2026-0001" \
--data '{
"amount": 150,
"redirect_url": "https://merchant.example/success"
}'Open payment_url to let the customer pay.
3. Verify then deliver
curl --fail-with-body "$EKMIVO_API_ORIGIN/v1/payment/verify" \
-H "Authorization: Bearer $EKMIVO_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"invoice_id": "550e8400-e29b-41d4-a716-446655440000"
}'Deliver only when
status === "COMPLETED" and invoice_id, amount and currency match your order. HTTP 200 alone does not mean paid.