User-Partner Coin Redemption - Bvndle LAAS Docs

{
  "status": "success",
  "message": "coin transferred",
  "data": {
    "reference": "ord-20261023-000123",
    "state": "succeeded",
    "coinsLedger": {
      "userId": "3f1c2b8e-6a4d-4e2f-9b1a-7c5d8e9f0a12",
      "coins": 500,
      "debitOrCredit": "DE",
      "walletBalanceBefore": 1700,
      "walletBalance": 1200
    }
  }
}

{
  "status": "success",
  "message": "coin transferred",
  "data": {
    "reference": "ord-20261023-000123",
    "state": "succeeded",
    "coinsLedger": {
      "userId": "3f1c2b8e-6a4d-4e2f-9b1a-7c5d8e9f0a12",
      "coins": 500,
      "debitOrCredit": "DE",
      "walletBalanceBefore": 1700,
      "walletBalance": 1200
    }
  }
}

cURL

curl --request POST
'https://test-api.bvndle.com/api/v2/laas/coins/transfer-from-user-wallet' \
--header 'Content-Type: application/json' \
{
    "userId": "d3c0c232-6e07-40eb-a1ee-593483d689c9",
    "coins": 20
}

Response

Always HTTP 200 once accepted. Check data.state:

succeeded — settled; data.coinsLedger shows the user’s wallet movement (debitOrCredit: "DE").
processing — accepted and will settle; poll Get Transfer Status with the same reference.

If the user has too few coins, the request fails with 400 insufficient_funds (“Insufficient Coins”).

{
  "status": "success",
  "message": "coin transferred",
  "data": {
    "reference": "ord-20261023-000123",
    "state": "succeeded",
    "coinsLedger": {
      "userId": "3f1c2b8e-6a4d-4e2f-9b1a-7c5d8e9f0a12",
      "coins": 500,
      "debitOrCredit": "DE",
      "walletBalanceBefore": 1700,
      "walletBalance": 1200
    }
  }
}