Validação do cartão baseado no método Zero Auth

POST 
/cards/verification

O propósito desse endpoint é validar a autenticidade de um cartão de crédito fornecido pelo portador. Um cartão válido é aquele que não está cancelado, bloqueado ou sujeito a restrições. Essa verificação assegura a integridade do cartão, contribuindo para transações seguras e livres de complicações.

Request

Header Parameters

caller-origin string

Inclua a propriedade 'caller-origin' como uma string no header das requisições REST somente se a aplicação for uma plataforma de e-commerce, caso contrário, não inclua.

application/json

Body

required

cardType stringrequired

Possible values: [CREDIT]

cardNumber stringrequired

Possible values: >= 13 characters and <= 16 characters, Value must match regular expression ^\d+$

cvv stringrequired

Possible values: >= 3 characters and <= 4 characters, Value must match regular expression ^\d+$

cardholderDocument Stringrequired

Possible values: Value must match regular expression ^\d{9}$|^\d{11}$|^[A-Z0-9]{9}$

expirationMonth int32required

Possible values: >= 1 and <= 12

expirationYear int32required

Os intervalos de ano aceitos estão entre ano atual e ano atual +19

Responses

200

OK

application/json

Schema

Schema

authorization string
nsu string
acquirerErrorCode string
acquirerErrorMessage string
isValid boolean
cardId string

Example (from schema)

{
  "authorization": "string",
  "nsu": "string",
  "acquirerErrorCode": "string",
  "acquirerErrorMessage": "string",
  "isValid": true,
  "cardId": "string"
}

400

Bad Request

application/json

Schema

Schema

message stringrequired
success booleanrequired

errors

object[]

Array [

message string

field string

]

Example (from schema)

{
  "message": "string",
  "success": true,
  "errors": [
    {
      "message": "must be a well-formed UUID string",
      "field": "merchantChargeId"
    }
  ]
}

401

Unauthorized

application/json

Schema

Schema

message stringrequired
success booleanrequired

errors

object[]

Array [

message string

field string

]

Example (from schema)

{
  "message": "string",
  "success": true,
  "errors": [
    {
      "message": "must be a well-formed UUID string",
      "field": "merchantChargeId"
    }
  ]
}

Example

{
  "message": "Authorization token not found.",
  "success": false,
  "errors": {
    "message": "Authorization token not found",
    "field": "Authorization Token"
  }
}

415

Unsupported Media Type

application/json

Schema

Schema

message stringrequired
success booleanrequired

errors

object[]

Array [

message string

field string

]

Example (from schema)

{
  "message": "string",
  "success": true,
  "errors": [
    {
      "message": "must be a well-formed UUID string",
      "field": "merchantChargeId"
    }
  ]
}

Example

{
  "message": "Request object is invalid or incorrectly formatted",
  "success": false,
  "errors": null
}

500

Internal Server Error

application/json

Schema

Schema

message stringrequired
success booleanrequired

errors

object[]

Array [

message string

field string

]

Example (from schema)

{
  "message": "string",
  "success": true,
  "errors": [
    {
      "message": "must be a well-formed UUID string",
      "field": "merchantChargeId"
    }
  ]
}

Loading...