Autenticação: Publica (sem autenticacao, CSRF dispensado) — voltada ao comprador.
- Monta um dicionario de configuracao a partir da venda online e do seu plano (valor, parcelas maximas, configuracao do boleto).
- Aciona a criacao da transacao na infraestrutura de processamento configurada.
- Cria um registro de pagamento do checkout combinando o link e o cliente, e vincula a transacao resultante.
OnlineSell.amount); o comprador nao pode sobrescrever.
Pre-requisitos
- O Link de checkout deve existir.
- O Plano de pagamento do link deve permitir o
typeescolhido (allow_credit_card/allow_pix/allow_boleto).
Parametros de caminho
UUID do link de checkout.
Corpo da requisicao
Um de
credit_card, pix, boleto.Nome completo do comprador — deve conter ao menos duas palavras.
E-mail do comprador.
Telefone do comprador, somente digitos. Validado pelo
country_code. Maximo 15.Codigo do pais do telefone (
+55, +1, …).Obrigatorio quando
type=credit_card. Intervalo 1-21.Obrigatorio quando
type=credit_card. Ou { "id": "<token>" } ou { "number", "cvv", "name", "expirationMonth", "expirationYear" }. number maximo 16; cvv maximo 4; name maximo 255; expirationMonth 2 caracteres; expirationYear 4 caracteres.Digitos de CPF/CNPJ. Obrigatorio quando
type=boleto. Maximo 14.Obrigatorio quando
type=boleto. Chaves: line1, line2, neighborhood, city, state (2 letras), postalCode (8 digitos, todos numericos).Resposta
200 OK. A transacao pode estar succeeded (cartao de credito) ou ainda pending (PIX/boleto aguardando acao do comprador).
Status retornado pela infraestrutura de processamento:
succeeded, pending, failed, etc.Presente apenas quando
type=boleto. URL do PDF do boleto hospedado.Presente apenas quando
type=pix. EMV BR Code (copia e cola).Presente apenas quando
type=pix. Imagem QR no formato data:image/png;base64,... gerada pelo servidor.UUID interno da transacao. Nota: omitido neste endpoint na implementacao atual — apenas Criar pagamento inclui esse campo. O comprador deve consultar Buscar transacao por ID legado para acompanhar.
Erros
| Status | Quando |
|---|---|
400 | Validacao do corpo falhou (campos ausentes, telefone invalido, endereco invalido). |
402 | Cartao recusado — o payload de erro da infraestrutura de processamento e retornado. |
405 | Metodo diferente de POST. |