Zeroauth & validation

Zeroauth authorizes R$ 0.00 (or the minimum amount) to confirm the card is valid. The BIN lookup identifies the brand, type and country of a card.

POST/api/v1/bank/wallet/zeroauth/

Runs a zero-amount authorization to confirm the card is valid.

Request

POST /bank/wallet/zeroauth/
Authorization: Bearer <token>
Content-Type: application/json

{
  "wallet_uuid": "00000000-0000-0000-0000-000000000000",
  "merchant_uuid": "9a1e2b3c-4d5f-6789-abcd-ef0123456789",
  "card_holder_name": "JOAO DA SILVA",
  "card_number": "4111111111111111",
  "card_expiry_month": "12",
  "card_expiry_year": "2030",
  "card_cvv": "123",
  "brand": "VISA"
}

Response

{
  "internal_uuid": "aa1b2c3d-4e5f-6789-abcd-ef0123456789",
  "is_valid": true,
  "code": "00"
}

BIN lookup

GET/api/v1/bank/wallet/bin/<card_bin>/

Returns brand data for the first 6 digits of the card.

Request

GET /bank/wallet/bin/411111/
Authorization: Bearer <token>

Response

{
  "bin": "411111",
  "brand": "visa",
  "type": "credit",
  "category": "standard",
  "issuer": "BANCO TESTE SA",
  "country": "BR"
}