Payment Links & Checkout

Sell without building a checkout: the payment link generates a hosted payment page with Pix, cards and the methods enabled on your account.

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

Creates a payment link. You set the amount, accepted methods and sale items; the platform hosts the page.

Request

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"
}

Response

{
  "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"
}

Payer flow

You create the payment link and receive the url.
Send the url to the buyer by email or WhatsApp, or place it on your site.
The buyer picks the method (Pix or card) on the hosted page.
On approval, the store receives the webhook and the amount goes to settlement by the acquirer into your account.