Cria um link de pagamento

POST/v1/payment-links

https://integrate.api.kyvopay.com.br

cURL

curl -X POST https://integrate.api.kyvopay.com.br/v1/payment-links \
  -H "X-API-Key: ky_XXXXX-XXXXX-XXXXX" \
  -H "Content-Type: application/json" \
  -d '{
  "amount_centavos": 4990,
  "collect_customer_data": false,
  "description": "Pedido #12345",
  "expires_at": "2026-01-01T12:30:00Z",
  "max_sales": 0,
  "min_amount_centavos": 4990,
  "name": "Cliente Exemplo",
  "slug": "string"
}'

Resposta200 OK

{
  "data": {
    "amount_centavos": "4990",
    "checkouts_started": 0,
    "collect_customer_data": false,
    "description": "Pedido #12345",
    "expires_at": "2026-01-01T12:30:00Z",
    "id": "01HZ8K3M5N",
    "max_sales": "string",
    "min_amount_centavos": "4990",
    "name": "Cliente Exemplo",
    "revenue_centavos": "4990",
    "sales_count": 0,
    "slug": "string",
    "starts_at": "2026-01-01T12:00:00Z",
    "status": "pending",
    "visits": 0
  },
  "error": {
    "code": "string",
    "details": {},
    "message": "string"
  },
  "request_id": "req_01HZ8K3M5N"
}

Autenticação

X-API-Keystring · headerobrigatório

Use a chave ky_... criada em Integrações → Chaves de API no painel KyvoPay.

Requisição

Corpo

amount_centavosinteger

Valor em centavos. R$ 49,90 = 4990.

collect_customer_databoolean

—

descriptionstring

Descrição livre, exibida ao pagador quando aplicável.

expires_atstring

Data e hora em que expira (RFC 3339, UTC).

max_salesinteger

—

min_amount_centavosinteger

Valor mínimo aceito, em centavos.

namestringobrigatório

Nome.

slugstring

Trecho da URL pública do link.

Precisa de ajuda? Fale com o suporte

curl -X POST https://integrate.api.kyvopay.com.br/v1/payment-links \ -H "X-API-Key: ky_XXXXX-XXXXX-XXXXX" \ -H "Content-Type: application/json" \ -d '{ "amount_centavos": 4990, "collect_customer_data": false, "description": "Pedido #12345", "expires_at": "2026-01-01T12:30:00Z", "max_sales": 0, "min_amount_centavos": 4990, "name": "Cliente Exemplo", "slug": "string" }'

{ "data": { "amount_centavos": "4990", "checkouts_started": 0, "collect_customer_data": false, "description": "Pedido #12345", "expires_at": "2026-01-01T12:30:00Z", "id": "01HZ8K3M5N", "max_sales": "string", "min_amount_centavos": "4990", "name": "Cliente Exemplo", "revenue_centavos": "4990", "sales_count": 0, "slug": "string", "starts_at": "2026-01-01T12:00:00Z", "status": "pending", "visits": 0 }, "error": { "code": "string", "details": {}, "message": "string" }, "request_id": "req_01HZ8K3M5N" }