---
title: "Creates a pix-to-token ticket"
method: POST
path: "/superuser/buy/pix-to-token"
tags: ["Buy Operations"]
---

# Creates a pix-to-token ticket

`POST /superuser/buy/pix-to-token`

Creates a ticket for buying other tokens. Amount received fluctuates and is calculated at the time the payment is detected

## Query parameters

- `taxId` string, required

## Request body

- BuyPixToTokenInput
  - `amount` integer, required — Amount in cents (e.g. 10 would represent R$0.10)
  - `token` 'BRLA' | 'USDC' | 'USDT' | 'ETH' | 'GLMR' | 'MATIC' | 'CHZ', required — Not all coins might be available for every operation
  - `markup` string — If the user wants to add an extra % fee to the operation to be delivered to another wallet. Represents a percentage with at most 4 decimal places (e.g. 0.001 is 0.1%)
  - `receiverAddress` string, required
  - `markupAddress` string
  - `externalId` string — External id you can input to help later conciliation. Up to 40 alphanumeric characters.

## Response `201`

Pix-to-token ticket created

- BuyPixToTokenOutput
  - `id` string, uuid
  - `due` string, date-time
  - `brCode` string — BR Code to be paid. If you want to create a QR Code, this should be its content
  - `markupBRLA` string

## Other responses

- `400` — Input could not be validated
- `401` — Authorization failure
- `429` — Rate limited
- `500` — Error internal to the server which probably shouldn't have happened, try again later

---

[API](https://skmtc.net/brla/apis/brla-superuser-api.md) · [All operations](https://skmtc.net/brla/apis/brla-superuser-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brla/brla-superuser-api/revisions/236b95ba5c14/schema)