Skip to main content
POST
/
charges
Creates a charge
curl --request POST \
  --url https://api.commerce.coinbase.com/charges \
  --header 'Content-Type: application/json' \
  --header 'X-CC-Api-Key: <api-key>' \
  --data '{
  "metadata": {
    "custom_field": "internal_id",
    "custom_field_two": "anything"
  }
}'
{
  "web3_data": {
    "contract_addresses": {
      "1": "0xabc123",
      "137": "0x987654"
    }
  }
}

Authorizations

​
X-CC-Api-Key
string
header
required

Body

application/json
​
pricing_type
enum<string>
required
Available options:
fixed_price,
no_price
​
buyer_locale
string
​
cancel_url
string<uri>
​
checkout_id
string
​
local_price
object
​
metadata
object
​
redirect_url
string<uri>

Response

Charge

​
charge_kind
enum<string>
required
Available options:
WEB3
​
code
string
required
​
created_at
string<date-time>
required
​
expires_at
string<date-time>
required
​
hosted_url
string<uri>
required
​
id
string<uuid>
required
​
pricing
object
required
​
pricing_type
enum<string>
required
Available options:
fixed_price,
no_price
​
support_email
string<email>
required
​
timeline
object[]
required
​
web3_data
object
required
​
brand_color
string
​
brand_logo_url
string<uri>
​
checkout
object
​
confirmed_at
string<date-time>
​
description
string
​
name
string
​
organization_name
string
​
redirects
object
​
third_party_provider
string