> ## 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.

# Partner-User Coin Redemption

> This endpoint enables partners to credit coins to users 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-to-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 within the short wait; `data.coinsLedger` shows the user's wallet movement (`debitOrCredit: "CR"`).
* `processing` — accepted and will settle; poll [Get Transfer Status](https://docs.bvndle.com/coins/get-transfer-status.md) with the same `reference`. **Do not resend with a new reference** — that would credit the user twice.

Terminal failures (insufficient partner coins, unknown wallet, reference conflict) are returned with a **4xx** status.

```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": "CR",
      "walletBalanceBefore": 1200,
      "walletBalance": 1700
    }
  }
}
```


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