[POST] /pix/v1/payment

Content-Type

application/json

string

Define o conteúdo como JSON

x-api-key

123

string

Sua chave API

transaction.value

number

Sim

Valor da transação. Aceita valores quebrados, separados por ponto, como 123.45, representando R$123,45, por exemplo.

transaction.description

string

Não

Descrição da cobrança

transaction.expirationTime

number

Não

Tempo de vida da cobrança, especificado em segundos, a partir do momento da criação da transação. Caso não seja informado, o valor padrão é 86400 segundos, que representa 24 horas.

transaction.externalId

string

Não

Identificador único para ser usado como rastreio das cobranças no envio do Webhook

transaction.additionalInfo

object

Não

Você pode enviar até 10 itens dentro do dicionário, além do “sellerId”, caso queira enviar.

O modelo é “chave e valor” e estas propriedades serão enviadas no retorno do Webhook.

transaction.additionalInfo.sellerId

string

Não

O ID do seu vendedor associado ao fluxo de cobrança. É um parâmetro opcional e pode ser utilizado para melhor tracking das cobranças geradas por um vendedor específico.

Esse cenário é muito comum para gateways ou intermediadores.

payer.fullName

string

Sim

Nome do cliente/pagador

payer.document

string

Sim

Documentação do cliente/pagador, CPF ou CNPJ

splits

array

Não

Lista de beneficiários a receber um valor pré-configurado após a cobrança ser efetivamente paga

splits[].pixKey

string

Sim

Chave PIX do beneficiário

splits[].pixKeyType

string | enum

Sim

Tipo da chave PIX do beneficiário.

Podendo ser dos tipos: "RANDOM_KEY" (chave-aleatória), "DOCUMENT" (CPF ou CNPJ) ou "EMAIL" (e-mail)

splits[].document

string

Sim

CPF ou CNPJ do beneficiário

splits[].externalId

string

Sim

Identificador único para que possa ser usado em caso de alteração/cancelamento do pagamento split

splits[].percent

number

Sim

Valor em percentual a ser enviado. Por exemplo: caso a cobrança seja de R$10,00 (dez reais) e seja informado o valor “10” no campo percent, então será considerado 10% sobre R$10,00, que é R$1,00.

Este valor pode ser somado automaticamente com o valor fixo (amount). Este valor não pode ser maior do que o valor líquido recebido pela cobrança.

splits[].amount

number

Sim

Valor fixo a ser enviado.

Este valor pode ser somado automaticamente com o valor percentual (percent). Este valor não pode ser maior do que o valor líquido recebido pela cobrança.

transactionId

string

Identificador único gerado para cobrança/transação

status

string

Status da cobrança/transação.

Inicialmente, "WAITING_PAYMENT“ é o status padrão após gerar uma cobrança e aguardar o pagamento do usuário

pixQrCode

string

Imagem QRCode codificado em Base64 (data:image/png;base64)

pixCode

string

Código PIX Copia e Cola

generateTime

string | timestamp

Data/momento da geração do pagamento

expirationDate

string | timestamp

Data/momento da expiração do pagamento

paymentLink

string

URL para link de pagamento