Criar transação

post

https://{apiUrl}/transactions

Para criar uma transação, use a rota /transactions, tanto para cartão de crédito, boleto ou PIX.

Cartões para testes em sandbox:

Número do Cartão	Bandeira	Status	Descrição
4012 8888 8888 1881	Visa	not_authorized	Transação não autorizada pelo banco emissor.

Body Params

cod_external

string

Código do pedido na loja

customer

object

Objeto com informações do cliente. OBS: Se estiver enviando um token de cartão do cliente, não precisa enviar os dados do customer novamente.

items

array of objects

required

Objeto com os itens do pedido

items*

payment

object

Objeto com os dados do pagamento

shipping

object

Objeto com endereço de entrega do produto

payer

object

Objeto com os dados do pagador

postbackUrl

string

URL em sua API que receberá atualizações da transação.

metadata

string

Objeto para loja enviar parametros

event

object

Em operação de ticketeira, enviar os dados do evento

platform

object

Para uso de plataformas de e-commerce/SaaS que precisa enviar assuas taxas finais de uma subconta.

3ds

boolean

Força a transação a utilizar ou não o 3DS. Enviar somente após ter permissão para gerenciar essa opção

Headers

Authorization

string

required

Defaults to Bearer

Chave privada gerada no painel, ou encaminhada pelo time de integração

X-Idempotency-Key

string

Esta funcionalidade permite reenviar uma solicitação com segurança, garantindo que a mesma operação não seja executada mais de uma vez por engano. Isso evita problemas como a criação duplicada de pagamentos. Para que o controle funcione corretamente, cada requisição deve incluir um identificador único no header. Recomendamos utilizar um UUID v4 ou uma string aleatória gerada dinamicamente. Assim, mesmo que a mesma requisição seja enviada novamente, o sistema conseguirá reconhecer e ignorar duplicidades.

Responses

200200

400400