Skip to main content
POST
Criar nova transação

Autorizações

Authorization
string
header
obrigatório

Autenticação por API Key usando token SK (sk_live_xxx ou sk_test_xxx). Envie como: Authorization: Bearer sk_live_xxx

Cabeçalhos

Idempotency-Key
string

Identificador único da operação (até 256 caracteres, ex. UUID ou ID do pedido). Torna a criação segura de repetir em timeout ou falha de rede, sem risco de pagamento duplicado.

Maximum string length: 256

Corpo

application/json
customer
object
obrigatório
payment
object
obrigatório
originDomain
string
obrigatório

Domínio da loja/site que originou a transação (ex: loja.exemplo.com.br). Obrigatório para rastreio de múltiplas lojas. Use apenas o hostname, sem protocolo ou caminho.

Required string length: 1 - 253
customerIp

IP do usuário final que originou a requisição (IPv4 ou IPv6). Quando informado, é usado para detecção de fraude e bloqueio de IPs.

Pattern: ^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$

Resposta

Default Response

success
boolean
padrão:true
obrigatório
data
object
obrigatório
message
string