Cadastra um novo perfil de pagamento para um cliente existente.

O perfil de pagamento representa um cartão de crédito ou uma conta bancária armazenada na plataforma Vindi. Leia mais na documentação.

Exemplo de requisição para cartão de crédito

{
  "holder_name": "José da Silva",
  "card_expiration": "12/2018",
  "card_number": "5167454851671773",
  "card_cvv": "123",
  "payment_method_code": "credit_card",
  "payment_company_code": "mastercard",
  "customer_id": 51
}

Exemplo de requisição para dados bancários

{
  "holder_name": "José da Silva",
  "registry_code": "27721264391",
  "bank_branch": "0964",
  "bank_account": "71233-1",
  "payment_method_code": "bank_debit",
  "payment_company_code": "itau",
  "customer_id": 51
}

Bandeiras e bancos disponíveis

Para uma lista completa de códigos de bancos e bandeiras suportadas pela sua conta, utilize o endpoint GET /payment_methods e verifique o atributo payment_companies.code.

Detecção automática de bandeira

Caso o parâmetro payment_company_code não seja informado, a plataforma irá tentar detectar a bandeira do cartão de crédito através do número informado. Este método não garante a detecção automática de bandeiras sem faixas de BIN/IIN definidas publicamente (Elo, Hipercard, Hiper, etc). Se você pretende utilizar cartões destas bandeiras, solicite a bandeira no seu formulário de pagamento e envie através do parâmetro payment_company_code.

No caso do débito em conta, payment_company_code é obrigatório.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Cadastra um novo perfil de pagamento para um cliente existente.

body
object

JSON com atributos do novo perfil de pagamento.

string

Nome do titular/portador do perfil de pagamento

string

CPF ou CNPJ do titular/portador

string

Agência da conta bancária

string

Número da conta bancária

string

Validade do cartão de crédito no formato MM/AA

string

Permite utilizar o perfil de pagamento em retentativas de cobranças não pagas.

string

Número completo do cartão de crédito

string

Código de segurança do cartão de crédito com 3 ou 4 dígitos

string

Código do método de pagamento

string

Código do banco ou bandeira

string

Data da renovação do cartão de crédito renovado

string

Token externo

int32
required

ID do cliente associado ao perfil de pagamento

Responses

Language
Credentials
Basic
base64
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json