Skip to content

Payment Initialization

Create a payment with POST /v1/merchants/{merchantID}/payments.

Provide amount_minor, currency, payment_method and customer references as required by your integration. Use GHS for Ghana (pesewas) and NGN for Nigeria (kobo).

Create payment

curl -X POST "$API/v1/merchants/$MERCHANT_ID/payments" \
  -H "X-API-Key: $TYVION_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "amount_minor": 10000,
    "currency": "GHS",
    "payment_method": "mobile_money",
    "customer_email": "buyer@example.com"
  }'

Sourced from backend developer guide and OpenAPI. If a field is missing from the published contract, it is intentionally omitted here.