documentation
Search
⌃K

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.

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
Response
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= [email protected]" \
-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=="
{
"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":" [email protected]",
"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":"[email protected] 11:53:56 +0000",
"timestamp":"2020-06-16 17:04:18+0000",
"ndc":"8a8294174e918ca6014e9c6f5ae12a9c_f72e1530daa04f1cbf650fbb60062ed8"
}