---
title: "Create incorporation payment"
method: POST
path: "/incorporate/start-payment"
tags: ["Incorporation"]
---

# Create incorporation payment

`POST /incorporate/start-payment`

## Request

- Base URL: `https://public-api-v2.bags.fm/api/v1`
- URL: `https://public-api-v2.bags.fm/api/v1/incorporate/start-payment`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/bags/apis/bags-public-api-v2/docs/incorporate/start-payment/post.ts> (a function with typed inputs; its response is checked against the schema)

Initiates a payment for token incorporation. Returns a pre-built transaction that must be signed and submitted on-chain.

## Request body

- object
  - `payerWallet` string, required: Wallet public key that will pay the incorporation fee
  - `payWithSol` boolean: Pay with SOL instead of USDC (defaults to false)

## Response `200`

Successfully created incorporation payment transaction

- object
  - `success` boolean, required
  - `response` object
    - `orderUUID` string, required: Unique identifier for the payment order
    - `recipientWallet` string, required: Treasury wallet to receive the payment
    - `priceUSDC` string, required: Incorporation price in USDC, as string to support bigint
    - `transaction` string, required: Base58 encoded serialized versioned transaction ready to be signed
    - `lastValidBlockHeight` number, required: Block height after which the transaction expires

## Other responses

- `400`: Bad request - Invalid payer wallet or payment parameters
- `401`: Unauthorized - Invalid or missing API key
- `500`: Internal server error

---

[API](https://skmtc.dev/bags/apis/bags-public-api-v2.md) - [All operations](https://skmtc.dev/bags/apis/bags-public-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/bags/apis/bags-public-api-v2/revisions/4a14b82cd39d?raw)