Charge Payment

​

Overview

​

Endpoint

POST /api/payments/charge

​

Request

​

Headers

​

Body parameters

​

Response

​

Success response

​

Examples

​

Single delivery payment

curl -X POST https://api.chidori.africa/api/payments/charge \
  -H "X-API-Key: sk_live_xxx.yyy" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryId": "abc123-def456-ghi789",
    "reference": "order_12345_payment"
  }'

{
  "status": true,
  "data": {
    "deliveryId": "abc123-def456-ghi789",
    "bulk": null,
    "amount": 2500,
    "paymentChannel": "Wallet",
    "reference": "order_12345_payment"
  }
}

​

Bulk payment behavior

1. The system identifies the bulk ID from the delivery
2. Calculates the total amount for all unpaid deliveries in that bulk
3. Charges the full bulk total from your wallet
4. Marks all deliveries in the bulk as paid

​

Idempotency

• If a request fails due to network issues, you can safely retry with the same reference
• If the original request succeeded, the retry will return the same response without double-charging
• Use unique references for each distinct payment (e.g., include your order ID)

// Good: Unique reference per order
const reference = `order_${orderId}_delivery_payment`;

// Bad: Reusing references across different orders
const reference = 'payment'; // Don't do this!

​

Error handling

​

Wallet management

​

Next steps