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

# Create Charge

> Generate a payment request for a Lightning Address.

## Description

If instead of sending Bitcoin payments directly to a given Lightning Address, you would rather create a Payment Request QR code for that Lightning Address, you can use this API.

## Usage

Depending on your system's configuration or your product's UX, you may need the ability to generate Charges for specific users. For ZBD users that's easy using the ZBD Gamertag endpoints. For any user that is using a different provider, you can use this endpoint.

The way to think of this is:

<CardGroup cols={1}>
  <Card title="First" icon="1" color="#000000">
    Given `user@domain.com` Lightning Address and an `amount` property, this endpoint generates a Charge.
  </Card>

  <Card title="Second" icon="2" color="#000000">
    If this new Charge is paid, the payment is received by `user@domain.com`.
  </Card>
</CardGroup>

## Configuration

### Header Parameters

<ParamField required header="apikey" type="string">
  ZBD Project API Key
</ParamField>

<ParamField initialValue="application/json" header="Content-Type" type="string">
  Content Type
</ParamField>

### Body

<ParamField required body="lnaddress" type="string">
  The Lightning Address of the intended recipient
</ParamField>

<ParamField required body="amount" type="string">
  The amount for the Charge -> in millisatoshis
</ParamField>

<ParamField initialValue="‎" body="description" type="string">
  Note or comment of this Charge
</ParamField>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "lnaddress": "andre@zbd.gg",
      "amount": "15000",
      "invoice": {
        "uri": "lightning:lnbc100n1p3mtxc3pp5tz4srtee9c4gsvlcqa6azu60a2ak2fvrnk7jv52j6n0rzp0musnqhp5xt5ts9t74akf67j59ynkr5qz8x3hs4g09d3dttmjrwwdhrxgc03qcqzpgxqzfvsp5529t5y03yaakumqrm9cwr5t6nysnr5cv93pnvw089a25aa7wszas9qyyssqalswdlc92983203l5azl43nksehadfy2uahc9v6qwg67xs52z02hg6vh7alrm3yx46ywdrl3dxey75t9l2ekmuwc3tu4ug03dy729fspdld2lj",
        "request": "lnbc100n1p3mtxc3pp5tz4srtee9c4gsvlcqa6azu60a2ak2fvrnk7jv52j6n0rzp0musnqhp5xt5ts9t74akf67j59ynkr5qz8x3hs4g09d3dttmjrwwdhrxgc03qcqzpgxqzfvsp5529t5y03yaakumqrm9cwr5t6nysnr5cv93pnvw089a25aa7wszas9qyyssqalswdlc92983203l5azl43nksehadfy2uahc9v6qwg67xs52z02hg6vh7alrm3yx46ywdrl3dxey75t9l2ekmuwc3tu4ug03dy729fspdld2lj"
      }
    }
  }
  ```
</ResponseExample>
