Criar um Cartão

Esse recurso é para salvar cartões de crédito com segurança no vault da USEND PAY a fim de utilizá-los em compras futuras. Com ela você salva os dados do cartão e recebe um hash com a propriedade card_id.

POST/v1/cards

Parâmetros

Atributo	Obrigatório	Tipo
card_number	sim	string
card_expiration_date	sim	string
card_holder_name	sim	string
card_cvv	sim	string

tip

Toda vez que você fizer uma transação com o USEND PAY, a nossa API já cria automaticamente um hash de card_id, assim você já pode salvar esses dados para o seu cliente usar nas próximas transações. Exemplo de utilização: one-click buy.

Request

HEADERS

Content-Type

application/json

api_key

api_key_value

Deve ser passado no HEADER da requisição.

BODY

card_number

string

Número do cartão.

card_expiration_date

string

Data de validade do cartão. Somente números no formato MMAA.

card_holder_name

string

Nome do portador do cartão.

card_cvv

string

Código verificador do cartão.

Atenção

Por questões de segurança, a USEND PAY não guarda nenhuma informação sobre os dados do cartão do seu cliente, inclusive o ID. Você deve salvar o card_id retornado na resposta em um local seguro na sua aplicação para poder recuperar os dados do cartão futuramente.

Exemplos

200 | OK

Request

  curl POST https://usendpay.marlim.co/v1/cards
  --H "Content-Type": "application/json"
  --H "api_key": "api_key_value"
  --data-raw '{
    "card_number": "111222233334444",
    "card_expiration_date": "1935",
    "card_holder_name": "Princess Leia Organa",
    "card_cvv": "155"
  }

Response

{
  "card_id": "card_chewbacca1234JabbaTheHutt",
  "date_created": "2005-05-19T00:00:00.000Z",
  "brand": "visa",
  "first_digits": "11122",
  "last_digits": "4444",
  "country": "USA",
  "fingerprint": "may1the2force3be4with5you",
  "expiration_date": "1935"
}