Payment Links e Checkout

Venda sem construir checkout: o payment link gera uma página de pagamento hospedada com Pix, cartão e os meios habilitados da sua conta.

POST/api/v1/bank/wallet/payment-link/

Cria um payment link. Você configura o valor, os meios aceitos e os itens da venda; a plataforma hospeda a página.

Requisição

POST /bank/wallet/payment-link/
Authorization: Bearer <token>
Content-Type: application/json

{
  "wallet_uuid": "00000000-0000-0000-0000-000000000000",
  "name": "Store checkout",
  "description": "Online orders",
  "value": 199.90,
  "currency": "BRL",
  "charge_type": ["credit_card", "pix"],
  "billing_type": "installment",
  "max_installment_count": 6,
  "items": [
    {
      "name": "T-shirt",
      "quantity": 1,
      "unit_amount": 99.95,
      "total_amount": 99.95
    },
    {
      "name": "Shipping",
      "quantity": 1,
      "unit_amount": 99.95,
      "total_amount": 99.95
    }
  ],
  "redirect_url": "https://your-store.com/thank-you",
  "webhook_url": "https://your-store.com/webhook/charge"
}

Resposta

{
  "wallet_uuid": "00000000-0000-0000-0000-000000000000",
  "payment_link_uuid": "5a6b7c8d-9e0f-1a2b-3c4d-5e6f7a8b9c0d",
  "url": "https://pay.ddpay.tech/link/5a6b7c8d...",
  "local_currency": 199.90,
  "currency": "BRL",
  "status": "active",
  "charge_type": ["credit_card", "pix"],
  "billing_type": "installment"
}

Fluxo do pagador

Você cria o payment link e recebe a url.
Envie a url para o comprador por e-mail, WhatsApp ou coloque no seu site.
O comprador escolhe o meio (Pix ou cartão) na página hospedada.
Aprovado, a loja recebe o webhook e o valor segue para liquidação pelo adquirente na sua conta.