Meios de Pagamento e Wallets no SmartForm

O parâmetro payments_supported permite informar quais métodos e bandeiras você deseja disponibilizar no formulário. Ele pertence a cada item de payments na chamada POST /v1/charges.

Exemplo: filtrar bandeiras

{
  "type": "PAYMENT",
  "order_id": "PEDIDO-SF-0002",
  "amount": 1500,
  "currency": "BRL",
  "payments": [
    {
      "payment_method": "smartform",
      "amount": 1500,
      "payments_supported": ["VISA", "MASTERCARD", "ELO"]
    }
  ],
  "customer": {
    "name": "Cliente Exemplo",
    "email": "[email protected]"
  }
}

O campo aceita os identificadores AMEX, APPLE_PAY, SAMSUNG_PAY, GOOGLEPAY, ELO, MASTERCARD, MASTERCARD_DEBIT, MAESTRO, VISA, VISA_DEBIT e VISA_ELECTRON.

Carteiras digitais

Apple Pay, Google Pay e Samsung Pay constam entre os identificadores reconhecidos pela API, mas sua disponibilidade pode depender do contrato da empresa, habilitação no provedor, navegador, dispositivo e configuração do consumidor.

🚧

Método aceito ≠ método habilitado

Incluir um identificador no array não ativa uma carteira digital. Valide os meios efetivamente disponíveis para o seu estabelecimento e as combinações de dispositivo/navegador em sandbox.

Sem payments_supported

Quando não precisar restringir a lista, omita o campo e permita que o provedor determine os meios configurados no seu ambiente. A interface exibida pode variar conforme o contrato e o contexto da sessão.

Onde conferir o resultado

O formulário é renderizado pelo SDK PayZen, mas o resultado do pagamento deve ser confirmado pela API Cyclopay ou webhook. Veja Resultado e Comprovante.

Iniciar Venda · Exibir o Formulário.