documentation
Search…
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
1
curl https://test.oppwa.com/v1/payments \
2
-d "entityId=8a8294174e918ca6014e9c6f5ae12a9c" \
3
-d "merchantTransactionId=Order Number 123" \
4
-d "amount=0.00" \
5
-d "currency=BRL" \
6
-d "paymentType=PA" \
7
-d "paymentBrand=VISA" \
8
-d "card.number=4066559930861909" \
9
-d "card.holder=Jose da Silva" \
10
-d "card.expiryMonth=10" \
11
-d "card.expiryYear=2022" \
12
-d "card.cvv=123" \
13
-d "customer.merchantCustomerId=12345678909" \
14
-d "customer.givenName=Jose" \
15
-d "customer.surname=da Silva" \
16
-d "customer.email= [email protected]" \
17
-d "customer.ip=123.123.123.123" \
18
-d "descriptor=123 Usage" \
19
-d "billing.city=Sao Paulo" \
20
-d "billing.country=BR" \
21
-d "billing.state=SP" \
22
-d "billing.street1=Rua Itapeva 547" \
23
-d "billing.postcode=01332000" \
24
-d "customParameters[product]=1 month membership" \
25
-d "customParameters[merchant_website]=www.store.com" \
26
-d "recurringType=INITIAL" \
27
-d "testMode=EXTERNAL" \
28
-H "Authorization: Bearer OGE4Mjk0MTcyODFiOGVlMzAxMjgyOTkwNjZmNTBjZGJ8ZGVtbw=="
Copied!
1
{
2
"id":"8ac7a4a172bd2b750172be16b06668e3",
3
"paymentType":"PA",
4
"paymentBrand":"VISA",
5
"amount":"0.00",
6
"currency":"BRL",
7
"descriptor":"123 Usage",
8
"merchantTransactionId":"Order Number 123",
9
"result":{
10
"code":"000.100.112",
11
"description":"Request successfully processed in 'Merchant in Connector Test Mode'"
12
},
13
14
"card":{
15
"bin":"406655",
16
"last4Digits":"1909",
17
"holder":"Jose da Silva",
18
"expiryMonth":"10",
19
"expiryYear":"2022"
20
},
21
"customer":{
22
"givenName":"Jose",
23
"surname":"da Silva",
24
"merchantCustomerId":"12345678909",
25
"email":" [email protected]",
26
"ip":"123.123.123.123"
27
},
28
"billing":{
29
"street1":"Rua Itapeva 547",
30
"city":"Sao Paulo",
31
"state":"SP",
32
"postcode":"01332000",
33
"country":"BR"
34
},
35
"customParameters":{
36
"merchant_website":"www.store.com",
37
"product":"1 month membership"
38
},
39
"risk":{
40
"score":"0"
41
},
42
"buildNumber":"[email protected] 11:53:56 +0000",
43
"timestamp":"2020-06-16 17:04:18+0000",
44
"ndc":"8a8294174e918ca6014e9c6f5ae12a9c_f72e1530daa04f1cbf650fbb60062ed8"
45
}
Copied!
Last modified 1yr ago