ZeroAuth

Zero Auth is an API card validation tool. The validation allows the merchant to know if the card is valid or not before sending the final transaction authorization.

Quick links

• General

• Supported Brands and Currencies by Country

• Test Cards

• Sample - PreAuthorization (PA) - Zeroauth

General

A zero auth transaction allows the merchant to verify:

• if the card is valid at issuer level

• If the card number is correct

• if the CVV is correct

Test Cards

Brand	Number	Expiry	Verification
Master	5228644111420691	10/2022	123

Sample - Preauthorization (PA) - Zeroauth

A PA is created by sending a POST request over HTTPS to the /v1/payments resource. The request should include all required information such as your authentication credentials, the type of transaction, the amount and the payment information such as card details.

Example Preauthorization (PA) Request - Zeroauth

curl https://test.oppwa.com/v1/payments \
 -d "entityId=8a8294174e918ca6014e9c6f5ae12a9c" \
 -d "merchantTransactionId=Order Number 123" \
 -d "amount=0.00" \
 -d "currency=BRL" \
 -d "paymentType=PA" \
 -d "paymentBrand=VISA" \
 -d "card.number=4066559930861909" \
 -d "card.holder=Jose da Silva" \
 -d "card.expiryMonth=10" \
 -d "card.expiryYear=2022" \
 -d "card.cvv=123" \
 -d "customer.merchantCustomerId=12345678909" \
 -d "customer.givenName=Jose" \
 -d "customer.surname=da Silva" \
 -d "customer.email= [e-mail]" \
 -d "customer.ip=123.123.123.123" \
 -d "descriptor=123 Usage" \
 -d "billing.city=Sao Paulo" \
 -d "billing.country=BR" \
 -d "billing.state=SP" \
 -d "billing.street1=Rua Itapeva 547" \
 -d "billing.postcode=01332000" \
 -d "customParameters[product]=1 month membership" \
 -d "customParameters[merchant_website]=www.store.com" \
 -d "recurringType=INITIAL" \
 -d "testMode=EXTERNAL" \
 -H "Authorization: Bearer OGE4Mjk0MTcyODFiOGVlMzAxMjgyOTkwNjZmNTBjZGJ8ZGVtbw=="

Response

{
  "id":"8ac7a4a172bd2b750172be16b06668e3",
  "paymentType":"PA",
  "paymentBrand":"VISA",
  "amount":"0.00",
  "currency":"BRL",
  "descriptor":"123 Usage",
  "merchantTransactionId":"Order Number 123",
  "result":{
    "code":"000.100.112",
    "description":"Request successfully processed in 'Merchant in Connector Test Mode'"
  },
  
  "card":{
    "bin":"406655",
    "last4Digits":"1909",
    "holder":"Jose da Silva",
    "expiryMonth":"10",
    "expiryYear":"2022"
  },
  "customer":{
    "givenName":"Jose",
    "surname":"da Silva",
    "merchantCustomerId":"12345678909",
    "email":" [e-mail]",
    "ip":"123.123.123.123"
  },
  "billing":{
    "street1":"Rua Itapeva 547",
    "city":"Sao Paulo",
    "state":"SP",
    "postcode":"01332000",
    "country":"BR"
  },
  "customParameters":{
    "merchant_website":"www.store.com",
    "product":"1 month membership"
  },
  "risk":{
    "score":"0"
  },
  "buildNumber":"923d087e91e2036da6f8bcc4821c04aa6270d517@2020-06-16 11:53:56 +0000",
  "timestamp":"2020-06-16 17:04:18+0000",
  "ndc":"8a8294174e918ca6014e9c6f5ae12a9c_f72e1530daa04f1cbf650fbb60062ed8"
}