> ## Documentation Index > Fetch the complete documentation index at: https://docs.valorapayments.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Criar Pagamento > Cria um pagamento via PIX ou cripto. O campo `payment_method` determina o fluxo. Para `crypto`, inclua o objeto `crypto` com `currency` e `network`. ## OpenAPI ````yaml POST /v1/payments openapi: 3.1.0 info: title: Valora Payment Gateway description: >- Gateway de pagamentos brasileiro com suporte a PIX e cripto (USDT/USDC/EURC na rede Solana). ## Autenticação Todas as rotas exigem o header `x-api-key` com sua chave de API. ## Convenção de valores - **Request**: valores em **centavos** (inteiro). Ex: `5000` = R$50,00 - **Response**: valores em **BRL** (float). Ex: `50.0` = R$50,00 ## Formato de erro Todos os erros retornam `{ "error": { "code": "ERROR_CODE", "message": "..." } }` version: 1.0.0 contact: name: Suporte Valora url: https://valorapayments.com.br servers: - url: https://api.valorapayments.com.br description: Produção - url: https://sandbox.api.valorapayments.com.br description: Sandbox security: - ApiKey: [] paths: /v1/payments: post: tags: - Pagamentos summary: Criar pagamento description: >- Cria um pagamento via PIX ou cripto. O campo `payment_method` determina o fluxo. Para `crypto`, inclua o objeto `crypto` com `currency` e `network`. operationId: createPayment requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PaymentCreateRequest' examples: pix: summary: Pagamento PIX de R$50,00 value: payment_method: pix amount: 5000 currency: brl crypto: summary: Pagamento cripto USDT de R$50,00 value: payment_method: crypto amount: 5000 currency: brl crypto: currency: usdt network: solana responses: '201': description: Pagamento criado content: application/json: schema: $ref: '#/components/schemas/PaymentCreateResponse' examples: pix: summary: Resposta PIX value: payment_id: pay_3f1a8b2c-4d5e amount: 50 status: processing fee_brl: 1.5 net_amount_brl: 48.5 pix: qr_code: data:image/png;base64,iVBORw0KGgoAAAANSUh... copia_e_cola: 00020101021226770014br.gov.bcb.pix... expires_at: '2026-06-26T13:00:00.000Z' crypto: summary: Resposta cripto value: payment_id: pay_9e2c7d1a-5f6b amount: 50 status: pending fee_brl: 1.5 net_amount_brl: 48.5 payment_method: crypto crypto: currency: USDT network: solana qr_code: data:image/png;base64,iVBORw0KGgoAAAANSUh... payment_link: solana:BJ26ofuu...?amount=9.12&spl-token=Es9vMF... wallet_address: BJ26ofuuKFJwvBmwiN2mSUeBiNEUhi5xjSkAockDA86q amount: 9.123456 expires_at: '2026-06-26T13:30:00.000Z' '422': $ref: '#/components/responses/ValidationError' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' components: schemas: PaymentCreateRequest: type: object required: - payment_method - amount properties: payment_method: type: string enum: - pix - crypto description: Método de pagamento amount: type: integer description: 'Valor em centavos. Ex: `5000` = R$50,00' minimum: 100 example: 5000 currency: type: string enum: - BRL default: BRL description: Moeda de cobrança (sempre BRL) metadata: type: string description: >- JSON serializado com dados extras do seu sistema (ex: order_id, user_id) example: '{"order_id": "ord_123", "user_id": "usr_456"}' crypto: type: object description: Obrigatório quando `payment_method` é `crypto` required: - currency - network properties: currency: type: string enum: - usdt - usdc - eurc description: Token SPL na rede Solana network: type: string enum: - solana description: Blockchain de destino PaymentCreateResponse: type: object properties: payment_id: type: string example: pay_3f1a8b2c-4d5e amount: type: number description: Valor bruto em BRL example: 50 status: type: string enum: - pending - processing description: >- `processing` para PIX (QR gerado), `pending` para cripto (aguardando pagamento) fee_brl: type: number description: Taxa Valora em BRL example: 1.5 net_amount_brl: type: number description: Valor líquido creditado na carteira em BRL example: 48.5 expires_at: type: string format: date-time pix: type: object description: Presente apenas quando `payment_method` é `pix` properties: qr_code: type: string description: QR Code em base64 (data:image/png;base64,...) copia_e_cola: type: string description: Código PIX para copiar e colar payment_method: type: string description: Presente apenas quando `payment_method` é `crypto` crypto: type: object description: Presente apenas quando `payment_method` é `crypto` properties: currency: type: string example: USDT network: type: string example: solana qr_code: type: string description: QR Code do link Solana Pay em base64 payment_link: type: string description: >- URL Solana Pay — abra em carteiras compatíveis (Phantom, Solflare) wallet_address: type: string description: Endereço Solana que recebe o pagamento amount: type: number description: 'Valor no token escolhido (ex: USDT)' example: 9.123456 expires_at: type: string format: date-time Error: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string description: Código de erro em SNAKE_UPPER_CASE example: NOT_FOUND message: type: string description: Descrição legível do erro example: Pagamento não encontrado. responses: ValidationError: description: Dados inválidos na requisição content: application/json: schema: $ref: '#/components/schemas/Error' examples: missing_fields: value: error: code: MISSING_FIELDS message: 'Campos obrigatórios ausentes: payment_method, amount.' invalid_status: value: error: code: INVALID_STATUS message: >- Não é possível realizar esta operação em pagamento com status "paid". no_fee_rule: value: error: code: NO_FEE_RULE message: >- Nenhuma regra de taxa configurada para este método de pagamento. unsupported_method: value: error: code: UNSUPPORTED_PAYMENT_METHOD message: Método de pagamento não suportado. RateLimited: description: Limite de requisições excedido (60 req/min por API key) content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RATE_LIMITED message: Muitas requisições. Tente novamente em alguns instantes. InternalError: description: Erro interno do servidor content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INTERNAL_ERROR message: Ocorreu um erro interno. Por favor, tente novamente. securitySchemes: ApiKey: type: apiKey in: header name: x-api-key description: Chave de API gerada no painel Valora. Envie em todas as requisições. ````