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

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

Supported Brands and Currencies by Country

Only PreAuthorization (PA) with amount 0.00 is permitted.

Country

Currency

Credit Card brands

Brazil

BRL

ELO MASTER VISA

Test Cards

Brand

Number

Expiry

Verification

Visa

4066559930861909

10/2022

123

Master

5228644111420691

10/2022

123

Elo

4389354088985860

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
Response
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= info@provider.com" \
-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":" info@provider.com",
"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"
}