Debit Multiple Wallets

This endpoint enables partners to debit multiple wallets linked to a user

Debits up to 100 linked wallets for one user in a single command (operation MULTI_DEBIT), in the order given, each up to its own cap, until amount is collected.

Body

Unknown fields are rejected. The total to debit is supplied in amount, not coins.

Example Request

cURL

curl --location -g '{{baseUrl}}/api/v2/laas/coins/debit-multiple-wallets' \
--header 'Content-Type: application/json' \
--data '{
  "userId": "{{userId}}",
  "amount": 1500,
  "reference": "{{reference}}",
  "narration": "Checkout #A-5521",
  "wallets": [
    {
      "id": "{{walletId1}}",
      "coins": 1000
    },
    {
      "id": "{{walletId2}}",
      "coins": 800
    }
  ]
}'

Response

Always HTTP 200 once accepted, with message: "wallets debited successfully" and data.state of succeeded or processing.

data.coinsLedger is normally absent when several wallets moved; it appears only when exactly one user wallet moved.

For processing, poll Get Transfer Status with the same reference.

Failures Specific to This Route

200 - Succeeded

{
  "status": "success",
  "message": "wallets debited successfully",
  "data": {
    "reference": "ord-20261023-000123",
    "state": "succeeded"
  }
}