Tokenizar cartão
Recomendação
Para validar se as informações do cartão estão corretas antes de tokenizar, recomendamos que você use a validação Zero Dollar antes.
Fazendo Requisição
A chamada deverá ser feita utilizando o método POST.
É necessária a autenticação via Authorization header.
POST/v1/card_payments/tokenize_cardParâmetros de Requisição
| Atributo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
card_number | string | Número do cartão, sem espaços ou traços | Sim |
card_expiration_date | string | Data de expiração do cartão, no formato MMyyyy (ex.: 012029) | Sim |
card_security_code | string | Código de segurança (CVV/CVC) | Sim |
Exemplo de Requisição
GET /v1/card_payments/tokenize_card
{
"card_expiration_date": "012029",
"card_security_code": "123",
"card_number": "4111111111111111"
}
Sucesso
HTTP 200 Response Body - Exemplo
{
"code": "ACCEPTED",
"tokenized_card": {
"slug_token": "45F2106AE4D740A5B7C8FAAF7C244AAA",
"token_expiration_date": "102028",
"active": "ACTIVE"
},
"stored_card": {
"slug_stored_card": "45F2106AE4D740A5B7C8FAAF7C2445FA",
"active": "CARD_STORED"
},
"multiacq_id": "021",
"status": "ok"
}
Erros
HTTP 422 Response Body - Unprocessable Entity - Exemplo
{
"request_token": "5B018B0166884D999799E5F3C41D0051",
"code": "TOKENIZATION_FAILED",
"msg": "400 BAD_REQUEST",
"multiacq_id": "021",
"status": "unprocessable_entity"
}
{
"errors": [
{
"code": "AUTHORIZER_REJECTED",
"msg": "46 - Identification required"
}
],
"muid": "f251e1b753504766957cf4142e936262",
"request_token": "83329FF45587498D88E1590C7FB78CD8",
"amount": 1,
"currency": "BRL",
"tracking_number": "00010609171144580010000000324834",
"last_digits": "1111",
"transaction_status": "REJECTED",
"brand_response_code": "83",
"multiacq_id": "021"
}
Atributos de Resposta
| Atributo | Tipo | Descrição |
|---|---|---|
code | string | Response code from transaction result. |
msg | string | Response message from transaction result. |
tokenized_card | object | Informações de dados de cartão tokenizadas. |
slug_token | string | Informações de recuperação do token. |
token_expiration_date | string | Data de validade do token no formato MMyyyy. |
active | string (enum) | Estado atual do token. Valores: |
ACTIVE UNPROVISIONED | ||
stored_card | object | Informações do cartão armazenadas. |
slug_stored_card | string | Identificação do cartão armazenado. Pode ser enviado na solicitação de venda em vez das informações do cartão. |
active | const (enum) | Estado do cartão armazenado |
request_token | string | String exclusiva que identifica a solicitação. |
status | string | Status da requisição |