---
title: "Iniciar pagamento Pix"
method: POST
path: "/v1/marketplace/banking/transfers/pix-init"
tags: ["Transferências"]
---

# Iniciar pagamento Pix

`POST /v1/marketplace/banking/transfers/pix-init`

## Headers

- `mTLS` string, required
- `integration-key` string, required
- `x-token` string, required

## Request body

- PixPaymentInitDto
  - `type` 'HASH' | 'CPF' | 'CNPJ' | 'EMAIL' | 'PHONE' | 'RANDOM', required — Tipo da chave Pix.
  - `key` string — Chave Pix. Obrigatório quando o tipo não for HASH.
  - `hash_code` string — Código copia e cola. Obrigatório quando o tipo for HASH.

## Response `200`

- PixPaymentInitResponse
  - `_id` string, required — ID do pagamento.
  - `type` string, required — Tipo do pagamento.
  - `status` string, required — Status do pagamento.
  - `establishment_id` string, required — ID do estabelecimento.
  - `init_type` string, required — Tipo de inicialização.
  - `transaction_identification` string, nullable — Identificação da transação.
  - `gateway_authorization` string, required — Gateway autorizador.
  - `fees_details` PixPaymentFeeDetail[], required — Detalhes das taxas.
    - `name` string, required — Nome da taxa.
    - `amount` number, required — Valor da taxa em centavos.
    - `description` string, required — Descrição da taxa.
    - `_id` string, required — ID da taxa.
  - `expected_at` string, required — Data prevista.
  - `pixKey` string, required — Chave Pix.
  - `recipient` PixPaymentRecipient, required
    - `first_name` string, required — Primeiro nome do recebedor.
    - `document` string, required — Documento do recebedor.
    - `bank_ispb` string, required — ISPB do banco.
    - `bank_name` string, required — Nome do banco.
    - `routing_number` string, required — Número da agência.
    - `routing_check_digit` string, required — Dígito da agência.
    - `account_number` string, required — Número da conta.
    - `account_check_digit` string, required — Dígito da conta.
    - `account_type` string, required — Tipo da conta.
    - `pix_key` string, required — Chave Pix.
    - `pix_key_type` string, required — Tipo da chave Pix.
    - `type` string, required — Tipo.
  - `payer` PixPaymentPayer, required
    - `bank_code` string, required — Código do banco.
    - `bank_name` string, required — Nome do banco.
    - `routing_number` string, required — Número da agência.
    - `account_number` string, required — Número da conta.
    - `account_check_digit` string, required — Dígito da conta.
    - `establishment` PixPaymentPayerEstablishment, required
      - `id` number, required — ID do estabelecimento.
      - `first_name` string, required — Primeiro nome do estabelecimento.
      - `last_name` string, required — Último nome do estabelecimento.
      - `document` string, required — Documento do estabelecimento.
      - `type` string, required — Tipo do estabelecimento.
      - `access_type` string, required — Tipo de acesso do estabelecimento.
      - `risk` string, required — Risco.
      - `active` boolean, required — Estabelecimento ativo.
      - `mcc` string, required — MCC.
    - `marketplace` PixPaymentPayerMarketplace, required
      - `id` number, required — ID do marketplace.
      - `nickname` string, required — Apelido do marketplace.
      - `first_name` string, required — Primeiro nome do marketplace.
      - `last_name` string, required — Último nome do marketplace.
      - `document` string, required — Documento do marketplace.
      - `type` string, required — Tipo do marketplace.
      - `active` boolean, required — Marketplace ativo.
    - `type` string, required — Tipo da conta.
  - `history` PixPaymentHistory[], required — Histórico do pagamento.
    - `status` string, required — Status histórico.
    - `created_at` string, required — Data do histórico.
    - `_id` string, required — ID do histórico.
  - `method` string, required — Método do pagamento.
  - `description` string, required — Descrição do pagamento.
  - `init_id` string, required — ID do init.
  - `end_to_end` string, required — End-to-end.
  - `reprocessed` boolean, required — Reprocessado.
  - `commission_id` string, nullable — ID da comissão.
  - `reversal_transaction_id` string, nullable — ID da reversão.
  - `transfer_id_fees_origin` string, nullable — ID da transferência de taxas de origem.
  - `created_at` string, required — Data de criação.
  - `updated_at` string, required — Data de atualização.
  - `__v` number, required — Versão do documento.

---

[API](https://skmtc.net/paytime/apis/api-p-blica.md) · [All operations](https://skmtc.net/paytime/apis/api-p-blica/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paytime/api-p-blica/revisions/5c818991d183/schema)