---
title: "Create Payment"
method: POST
path: "/v1/bridge/payments"
tags: ["Bridge"]
---

# Create Payment

`POST /v1/bridge/payments`

Create a payment to be executed. Users can complete the payment via hosted UI (link is returned), a transaction execution referencing the product ID, or embedded widgets with the product ID. 

**Authentication**: This endpoint requires project authentication.

## Request body

- object — Request to create a product to be purchased. Users can purchase the product via hosted UI (link is returned), a transaction execution referencing the product ID, or embedded widgets with the product ID.
  - `name` string, required — The name of the product
  - `description` string, required — The description of the product
  - `imageUrl` string — The URL of the product image
  - `token` object, required — The token to purchase
    - `address` string, required — The token address to purchase (use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for native token)
    - `chainId` integer, required — The blockchain network where the token is located
    - `amount` string, required — The amount of the token to purchase in wei.
  - `recipient` string, required — The wallet address or ENS name that will receive the payment for the product
  - `purchaseData` unknown

## Response `200`

Payment created successfully. Returns the ID and link to complete the payment.

- object — Successful payment creation response containing the payment ID and link to purchase the product
  - `result` object, required
    - `id` string, required — The payment ID
    - `link` string, required — The link to purchase the product

## Other responses

- `400` — Invalid request parameters.
- `401` — Authentication required. For backend usage, include `x-secret-key` header. For frontend usage, include `x-client-id` + `Authorization: Bearer <jwt>` headers.
- `500` — Internal server error. This may occur due to network connectivity issues, wallet creation failures, or transaction execution failures.

---

[API](https://skmtc.net/thirdweb/apis/thirdweb-api.md) · [All operations](https://skmtc.net/thirdweb/apis/thirdweb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thirdweb/thirdweb-api/versions/fb4cb67da1c7/schema)