Pagar link com cartão

post

https://api-hml.alliancepay.app/acquiring/payment-links/public/{public_token}/payments

Envia payment_method_id, CVV cifrado, pagador e browser. Use Idempotency-Key estável para a mesma tentativa. O valor vem do link. Informe o IP real do pagador em browser.ip_address e o User-Agent em browser.user_agent_browser_value. A resposta 201 confirma a criação/recuperação da tentativa, não a aprovação. Execute next_action no navegador quando houver 3DS e consulte status até o resultado. Após timeout/503, recupere pela mesma chave antes de repetir. Para checkout_mode=CARD_SETUP utilize /card-setups.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

public_token

string

required

length between 1 and 128

^[A-Za-z0-9_-]+$

Último segmento de checkout_url. Identifica o link; não substitui o token OAuth do parceiro.

Body Params

Dados do pagamento. Documento, telefone e endereço podem ser exigidos pela configuração retornada em checkout_requirements. Os valores da cobrança são definidos pelo link.

payment_method_id

uuid

required

payment_method

string

enum

Defaults to CREDIT

Allowed:

card

object

required

installments

integer

1 to 99

Defaults to 1

payer

object

required

browser

object

required

billing_address

object

Endereço brasileiro. Consulte required_fields em checkout_requirements; country deve ser BR, state duas letras e zip_code oito dígitos após normalização.

phone

object

Celular brasileiro: country_code=55, DDD de dois dígitos, número de nove dígitos começando por 9, após normalização.

recurring_consent

boolean

Defaults to false

apply_payment_method_to_remaining_installments

boolean

Defaults to false

consent_terms_version

string

length ≤ 100

Headers

X-Request-Id

string

length between 1 and 512

^[ -~]+$

Identificador de rastreio. Se omitido, o gateway gera um identificador. Retornado no cabeçalho X-Request-Id.

Idempotency-Key

string

required

length between 1 and 255

Chave estável da operação. Reutilizar a mesma chave ao consultar/repetir após timeout ou resposta pendente.

Responses

201Tentativa criada ou recuperada; confira o status do recurso.

400Parâmetros, corpo ou cabeçalhos inválidos. A resposta pode conter mensagens por campo.

401Token ausente, inválido ou expirado, ou credencial revogada.

403Permissão ou escopo insuficiente, ou requisição bloqueada pelo firewall.

404Recurso inexistente ou fora do escopo, rota não publicada, ou public_token de link que não pertence ao parceiro autenticado.

409Conflito com o estado do link/tentativa ou reutilização incompatível de chave de idempotência.

413Corpo acima do limite aceito pela infraestrutura. O bloqueio de 16 KB do firewall pode retornar 403.

414Query string codificada acima de 4096 caracteres.

429Limite de requisições atingido. Aguarde antes de tentar novamente. O firewall também pode responder 403.

500Falha interna no gateway ou na autorização.

502Falha de comunicação com o serviço ou resposta acima de 4 MB.

503Serviço temporariamente indisponível ou resultado do provedor incerto. Recupere o resultado pela mesma chave antes de repetir uma escrita.

504Tempo limite excedido. Em escritas, consulte o resultado antes de repetir; preserve a chave nas operações idempotentes.