> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bvndle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# User-Partner Coin Redemption

> This endpoint enables users to redeem coins for marketplace activities within the partner application

##

###

Req Body

#####

name
type
Description

###

```bash cURL theme={null}
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](https://docs.bvndle.com/coins/get-transfer-status.md) with the same `reference`.

If the user has too few coins, the request fails with **400** `insufficient_funds` ("Insufficient Coins").

```json 200 - Succeeded theme={null}
{
  "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
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.