---
title: "Criar link de pagamento"
method: POST
path: "/v2/payment-links"
tags: ["Links de Pagamento"]
---

# Criar link de pagamento

`POST /v2/payment-links`

Cria um novo link de pagamento

## Headers

- `X-Token-Api` string, required
- `Content-Type` 'application/json'
- `x-ip-origin-request` string
- `x-idempotency-key` string

## Request body

- PaymentLinkRequest
  - `type` 'ORDER' | 'SUBSCRIPTION' | 'FAST_ORDER', required
  - `scheduledDate` string, date — Data de vencimento do pedido (opcional)
  - `uuidSellerClient` string, uuid — UUID do comprador - se o link for específico para alguém (opcional)
  - `paymentOrder` PaymentOrderLinkRequest, required
    - `title` string, required
    - `description` string
    - `value` number, double, required
    - `installments` integer, required
    - `timer` boolean
    - `expirationDate` string, date-time — Data e hora de expiração do link de pagamento (opcional)
    - `customInstallmentsValues` CustomInstallmentValueRequest[], required — É preciso informar ao menos um método
      - `paymentMethod` 'PIX' | 'BANK_SLIP' | 'CREDIT_CARD' | 'CREDIT_CARD_EARLY_BUYER' | 'CREDIT_CARD_EARLY_SELLER' | 'DEBIT_CARD', required — Pode ser CREDIT_CARD (Fluxo do tempo), CREDIT_CARD_EARLY_SELLER (Antecipado com taxas pro seller) e CREDIT_CARD_EARLY_BUYER (Antecipado com taxas pro buyer)
      - `installments` integer, required
    - `threeDSecureEnabled` boolean — Ativa autenticação 3D Secure para pagamentos com cartão de crédito. Só tem efeito quando o link aceita CREDIT_CARD, CREDIT_CARD_EARLY_SELLER ou CREDIT_CARD_EARLY_BUYER como método de pagamento. Quando ativado, o checkout do comprador inicia o fluxo 3DS automaticamente (coleta de dados do navegador + possível desafio).
    - `requiresLiabilityShift` boolean — Exige liability shift para a transação ser aprovada. Quando true, transações sem liability shift são recusadas automaticamente.
  - `paymentSubscription` PaymentSubscriptionLinkRequest
    - `idPlan` string, uuid, required
    - `type` 'MONTHLY' | 'SEMESTER' | 'YEARLY', required
    - `valuePerMonth` number, double, required
  - `paymentMethods` string[], required
  - `metadata` MetadataRequest[]
    - `key` string, required
    - `value` union, required
      - string
      - number

## Response `200`

Link de pagamento criado com sucesso

- PaymentLinkResponse
  - `id` integer, required
  - `uuid` string, uuid, required
  - `type` 'ORDER' | 'SUBSCRIPTION' | 'FAST_ORDER', required
  - `url` string, uri, required
  - `scheduledDate` string, date
  - `paymentOrder` PaymentOrderLinkResponse
    - `title` string, required
    - `description` string
    - `value` number, double, required
    - `installments` integer, required
    - `customInstallmentsValues` CustomInstallmentValueResponse[]
      - `paymentMethod` 'PIX' | 'BANK_SLIP' | 'CREDIT_CARD' | 'CREDIT_CARD_EARLY_BUYER' | 'CREDIT_CARD_EARLY_SELLER' | 'DEBIT_CARD'
      - `installments` integer
    - `expirationDate` string, date-time
    - `timer` boolean
    - `threeDSecureEnabled` boolean
    - `requiresLiabilityShift` boolean
  - `paymentSubscription` PaymentSubscriptionLinkResponse
    - `idPlan` string, uuid, required
    - `type` 'MONTHLY' | 'SEMESTER' | 'YEARLY', required
    - `value` number, double, required
    - `valuePerMonth` number, double, required
  - `processed` integer
  - `enableAnchoring` boolean
  - `allowedPaymentMethods` object
    - `pixMethod` object
    - `bankSlipMethod` object
    - `creditCardMethod` object
      - `type` string
  - `paymentMethods` string[]
  - `enableBankSlip` boolean
  - `enableCreditCard` boolean
  - `enablePixPayment` boolean
  - `subSellerResponse` object[]
  - `idSeller` integer

## Other responses

- `400` — Erro de validação
- `401` — Token inativo ou inexistente
- `403` — Acesso negado
- `429` — Muitas requisições
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada.md) · [All operations](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/barte/api-de-sellers-v2-atualizada/revisions/f0dd55b167f1/schema)