Criar checkout link - Pagou Developer Docs

POST

checkout-links

Create a Checkout Link

curl --request POST \
  --url https://api.pagou.ai/v2/checkout-links \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 4503599627370496,
  "currency": "BRL",
  "title": "<string>",
  "products": [
    {
      "external_id": "<string>",
      "name": "<string>",
      "price": 4503599627370496,
      "quantity": 1,
      "description": "<string>",
      "image_url": "<string>",
      "compare_price": 4503599627370496
    }
  ]
}
'

{
  "success": true,
  "requestId": "<string>",
  "data": {
    "url": "<string>"
  }
}

Envie products[] (cada um referenciado pelo seu próprio external_id) ou um amount só-valor — nunca os dois. Os produtos passam por upsert por external_id, então reenviar o mesmo id atualiza o produto em vez de duplicar. A resposta é a url final do checkout. Para o guia completo de integração, links só-valor e prompts de IA, veja Criar checkout links.

Autorizações

Authorization

string

header

obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Corpo

application/json

amount

integer

Intervalo obrigatório: 1 <= x <= 9007199254740991

currency

enum<string>

padrão:BRL

Opções disponíveis:

BRL,

MXN,

COP,

CLP,

ARS,

PEN,

USD,

GTQ,

CRC,

NIO,

PYG,

UYU,

BOB,

PHP,

RUB,

INR,

SAR,

AED,

KWD,

QAR,

OMR,

KHR,

SGD,

IDR,

KRW,

THB,

MYR,

HKD,

CNY,

EGP,

EUR,

GBP,

BHD,

MAD,

AUD,

CAD,

CHF,

NZD,

PLN,

KZT,

UZS,

JPY,

GLC

title

string

Required string length: 1 - 255

products

object[]

Minimum array length: 1

Show child attributes

Resposta

HTTP 201 response

success

boolean

obrigatório

requestId

string

obrigatório

data

object

obrigatório

Show child attributes

Referência de Checkout Links

Referência de transferências

Create a Checkout Link

curl --request POST \
  --url https://api.pagou.ai/v2/checkout-links \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 4503599627370496,
  "currency": "BRL",
  "title": "<string>",
  "products": [
    {
      "external_id": "<string>",
      "name": "<string>",
      "price": 4503599627370496,
      "quantity": 1,
      "description": "<string>",
      "image_url": "<string>",
      "compare_price": 4503599627370496
    }
  ]
}
'

{
  "success": true,
  "requestId": "<string>",
  "data": {
    "url": "<string>"
  }
}