🔼
POST urlServidor/v1/marketplace/banking/transfers/pix-confirm

Obs: A palavra urlServidor deve ser substituída pela url do servidor.

Parâmetros da Requisição

Nome	Tipo	Obrigatório	Descrição
`integration-key`	string	Sim	Chave de integração.
`x-token`	string	Sim	Token utilizado para autenticação. Pode ser encontrado no portal da API.
`Authorization`	Auth Type Bearer Token	Sim	Inserir o Bearer Token, gerado na rota Auth

Exemplo de header da requisição

curl--request POST \
--location 'urlServidor/v1/marketplace/banking/transfers/pix-confirm' \
--header 'integration-key: your_integration_key' \
--header 'x-token: your_x_token' \
--header 'Authorization: Bearer {{bearer_token}}' \

📥 Body da requisição

{
 "type": "RANDOM",
 "key": "597b7eed-ab88-4c2b-947a-c8729f8e21ed",
 "amount": 100,
"init_id": "E13935893202604231306mtnQXCKoYpZ"
}

📌 Campos

Campo	Tipo	Obrigatório	Descrição
type	string	Sim	Tipo da chave Pix.
key	string	Condicional	Chave Pix. Obrigatória quando `type` ≠ `HASH`.
hash_code	string	Condicional	Código copia e cola. Obrigatório quando `type` = `HASH`.
amount	number	Sim	Valor da transferência em centavos.
init_id	string	Sim	Identificador retornado na etapa de init.

📤 Resposta

{
    "_id": "69f0f2cf71ad0804c940575a",
    "type": "PIX",
    "status": "PROCESSING",
    "establishment_id": "155392",
    "init_type": "DICT",
    "transaction_identification": null,
    "gateway_authorization": "CELCOIN",
    "fees_details": [],
    "expected_at": "2026-04-28T17:47:59.156Z",
    "pixKey": "597b7eed-ab88-4c2b-947a-c8729f8e21ed",
    "recipient": {
        "first_name": "DS DESENVOLVIMENTO DE SOFTWARES, APLICATIVOS E SISTEMAS LTDA",
        "document": "26244342000140",
        "bank_ispb": "13935893",
        "bank_name": "CELCOIN INSTITUICAO DE PAGAMENTO S.A.",
        "routing_number": "****",
        "routing_check_digit": "*",
        "account_number": "*******",
        "account_check_digit": "*",
        "account_type": "CHECKING",
        "pix_key": "597b7eed-ab88-4c2b-947a-c8729f8e21ed",
        "pix_key_type": "EVP",
        "type": "CHECKING"
    },
    "payer": {
        "bank_code": "509",
        "bank_name": "CELCOIN IP S.A.",
        "routing_number": "0001",
        "account_number": "422345",
        "account_check_digit": "9",
        "establishment": {
            "id": 155392,
            "first_name": "EC Final3",
            "last_name": "Final 3",
            "document": "31820784000128",
            "type": "BUSINESS",
            "access_type": "ACQUIRER",
            "risk": "LOW",
            "active": true,
            "mcc": "5044"
        },
        "marketplace": {
            "id": 26,
            "nickname": "Parceiro Integrações",
            "first_name": "Webhooks Integrações",
            "last_name": "API Integrações",
            "document": "60274849000185",
            "type": "LICENSED",
            "active": true
        },
        "type": "CHECKING"
    },
    "history": [
        {
            "status": "CREATED",
            "created_at": "2026-04-28T17:47:59.156Z",
            "_id": "69f0f2cf71ad0804c940575b"
        },
        {
            "status": "PROCESSING",
            "created_at": "2026-04-28T17:47:59.157Z",
            "_id": "69f0f2cf71ad0804c940575c"
        }
    ],
    "method": "OUT",
    "description": "",
    "init_id": "E13935893202604281747Y3pL5YlGFRs",
    "end_to_end": "E13935893202604281747Y3pL5YlGFRs",
    "reprocessed": false,
    "commission_id": null,
    "reversal_transaction_id": null,
    "transfer_id_fees_origin": null,
    "created_at": "2026-04-28T17:47:59.161Z",
    "updated_at": "2026-04-28T17:47:59.161Z",
    "__v": 0
}

📊 Estrutura da Resposta – Confirmar PIX

Campo	Tipo	Obrigatório	Descrição
`_id`	string	Sim	ID único do pagamento.
`type`	string	Sim	Tipo do pagamento (`PIX`).
`status`	string	Sim	Status atual da transação.
`establishment_id`	string	Sim	ID do estabelecimento.
`init_type`	string	Sim	Tipo de inicialização do Pix.
`transaction_identification`	string	Não	Identificador adicional da transação.
`gateway_authorization`	string	Sim	Gateway responsável pela autorização.
`fees_details`	array	Sim	Lista de taxas aplicadas.
`expected_at`	string (datetime)	Sim	Data prevista de liquidação.
`pixKey`	string	Sim	Chave Pix utilizada.
`recipient`	object	Sim	Dados do recebedor.
`payer`	object	Sim	Dados do pagador.
`history`	array	Sim	Histórico de status.
`method`	string	Sim	Método (`IN` ou `OUT`).
`description`	string	Sim	Descrição da transação.
`init_id`	string	Sim	ID retornado na inicialização.
`end_to_end`	string	Sim	Identificador único no Bacen.
`reprocessed`	boolean	Sim	Indica reprocessamento.
`commission_id`	string	Não	ID da comissão.
`reversal_transaction_id`	string	Não	ID da reversão.
`transfer_id_fees_origin`	string	Não	ID da transferência de taxas.
`created_at`	string (datetime)	Sim	Data de criação.
`updated_at`	string (datetime)	Sim	Data de atualização.
`__v`	number	Sim	Versão do documento.
`amount`	number	Sim	Valor da transação em centavos.
`fees`	number	Sim	Total de taxas em centavos.
`fees_banking`	object	Sim	Pacote de taxas aplicado.
`gateway_key`	string	Sim	Chave do gateway.
`original_amount`	number	Sim	Valor original da transação em centavos.

💰 Objeto fees_details

Campo	Tipo	Obrigatório	Descrição
`name`	string	Sim	Nome da taxa.
`amount`	number	Sim	Valor da taxa em centavos.
`description`	string	Sim	Descrição da taxa.
`_id`	string	Sim	ID da taxa.

👤 Objeto recipient

Campo	Tipo	Obrigatório	Descrição
`first_name`	string	Sim	Nome / razão social.
`document`	string	Sim	CPF ou CNPJ.
`bank_ispb`	string	Sim	ISPB do banco.
`bank_name`	string	Sim	Nome do banco.
`routing_number`	string	Sim	Agência.
`routing_check_digit`	string	Sim	Dígito da agência.
`account_number`	string	Sim	Conta.
`account_check_digit`	string	Sim	Dígito da conta.
`account_type`	string	Sim	Tipo da conta.
`pix_key`	string	Sim	Chave Pix.
`pix_key_type`	string	Sim	Tipo da chave.
`type`	string	Sim	Tipo da conta.

🏦 Objeto payer

Campo	Tipo	Obrigatório	Descrição
`bank_code`	string	Sim	Código do banco.
`bank_name`	string	Sim	Nome do banco.
`routing_number`	string	Sim	Agência.
`account_number`	string	Sim	Conta.
`account_check_digit`	string	Sim	Dígito da conta.
`type`	string	Sim	Tipo da conta.
`establishment`	object	Sim	Estabelecimento pagador.
`marketplace`	object	Sim	Marketplace pagador.

🏪 Objeto payer.marketplace

Campo	Tipo	Obrigatório	Descrição
`id`	number	Sim	ID do marketplace.
`nickname`	string	Sim	Apelido.
`first_name`	string	Sim	Nome / razão social.
`last_name`	string	Sim	Nome complementar.
`document`	string	Sim	CPF/CNPJ.
`type`	string	Sim	Tipo do marketplace.
`active`	boolean	Sim	Indica se está ativo.

🧮 Objeto fees_banking

Campo	Tipo	Obrigatório	Descrição
`id`	number	Sim	ID do registro.
`fees_banking_id`	number	Sim	ID do pacote de tarifas.
`name`	string	Sim	Nome do pacote.
`description`	string	Sim	Descrição.
`standard`	number	Sim	Taxa base em centavos.
`markup`	number	Sim	Markup aplicado em centavos.
`fees`	number	Sim	Total de taxas em centavos.

🧾 Objeto history

Campo	Tipo	Obrigatório	Descrição
`status`	string	Sim	Status naquele momento.
`created_at`	string	Sim	Data do evento.
`_id`	string	Sim	ID do histórico.

Códigos de Resposta

Consulte a página com os status: Status de respostas

Para mais detalhes sobre os parâmetros e funcionamento da API, acesse a documentação oficial da Paytime.