Endpoint: POST /sales/charge/{id}/pay
Autenticação: Publica (sem autenticacao, CSRF dispensado) — voltada ao comprador.
Endpoint chamado pela pagina hospedada Pagar venda publica e por qualquer interface de checkout customizada construida sobre Obter contexto publico da venda quando o comprador clica em “Pagar”. Dado o id de um Link de checkout e os dados de pagamento do comprador, ele:
  1. Monta um dicionario de configuracao a partir da venda online e do seu plano (valor, parcelas maximas, configuracao do boleto).
  2. Aciona a criacao da transacao na infraestrutura de processamento configurada.
  3. Cria um registro de pagamento do checkout combinando o link e o cliente, e vincula a transacao resultante.
O valor vem do link (OnlineSell.amount); o comprador nao pode sobrescrever.

Pre-requisitos

Parametros de caminho

id
string
required
UUID do link de checkout.

Corpo da requisicao

type
string
required
Um de credit_card, pix, boleto.
name
string
required
Nome completo do comprador — deve conter ao menos duas palavras.
email
string
required
E-mail do comprador.
phone
string
required
Telefone do comprador, somente digitos. Validado pelo country_code. Maximo 15.
country_code
string
default:"+55"
Codigo do pais do telefone (+55, +1, …).
installments
integer
Obrigatorio quando type=credit_card. Intervalo 1-21.
card
object
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.
taxpayerId
string
Digitos de CPF/CNPJ. Obrigatorio quando type=boleto. Maximo 14.
address
object
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).
payment.status
string
Status retornado pela infraestrutura de processamento: succeeded, pending, failed, etc.
payment.boleto.url
string
Presente apenas quando type=boleto. URL do PDF do boleto hospedado.
payment.pix.copy_paste
string
Presente apenas quando type=pix. EMV BR Code (copia e cola).
payment.pix.qr_code
string
Presente apenas quando type=pix. Imagem QR no formato data:image/png;base64,... gerada pelo servidor.
payment.id
string
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.
{
  "payment": {
    "status": "pending",
    "pix": {
      "copy_paste": "00020126360014BR.GOV.BCB.PIX...",
      "qr_code": "data:image/png;base64,iVBORw0KGgo..."
    }
  }
}

Erros

StatusQuando
400Validacao do corpo falhou (campos ausentes, telefone invalido, endereco invalido).
402Cartao recusado — o payload de erro da infraestrutura de processamento e retornado.
405Metodo diferente de POST.

Exemplos

curl -X POST "https://api.dlpay.cloud/sales/charge/$CHECKOUT_ID/pay" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "pix",
    "name": "Maria Souza",
    "email": "maria@example.com",
    "phone": "11999990000"
  }'