The Verification API is used for real-time access to our risk verification results.
To effectively prevent fraud and avoid product or financial losses, it is recommended that you send requests for risk verification at the following business checkpoints. By verifying at these critical points, you can ensure maximum protection for your products and funds.
example: https://us-efficient.apitd.net/fraud/transaction/v3?partner_code=test_code&partner_key=test_key
{
"channel": "test",
"session_id": "abc0123456789",
"decision_event": "order_payment",
"event_time": "2023-10-12T14:20:50.521+07:00",
"account_id": "123456789",
"order_id": "ID293846237467",
"terminal": {
"black_box": "aGPH1658920283672ropYaFxT7",
"ip": "210.20.10.33"
},
"ext": {
"ext_book_id": "LFOUHOFHOHFNOUH",
"ext_book_num": 10
},
"account": {
"account_id": "123456789",
"register_time": "2021-10-12T14:20:50.521+07:00",
"login_time": "2021-10-12T14:25:50.521+07:00",
"phone": {
"country_code": 1,
"phone_number": "6165793816"
},
"email": "hello@gmail.com"
},
"order": {
"order_id": "NX348566DIHD",
"order_create_time": "2021-10-12T14:25:50.521+07:00",
"merchandise_list": [
{
"merchandise_id": "NFH837824432",
"category_1": "3c",
"category_2": "phone",
"category_3": "android",
"name": "huawei phone",
"count": 1,
"unit_price": {
"currency": "USD",
"amount_local": 1000,
"amount_usd": 1000,
"amount_cny": 6800
}
}
],
"amount": {
"currency": "USD",
"amount_local": 1000,
"amount_usd": 1000,
"amount_cny": 6800
},
"shipping": {
"address": {
"country": "FR",
"region": "Grand Est",
"city": "Strasbourg City",
"district": "Ketali Lorem",
"detail": "3213 Building，lorem Street",
"zip_code": "310000"
},
"phone": {
"country_code": 1,
"phone_number": "18700001112"
},
"email": "hello@gmail.com",
"consignee": {
"first_name": "Pierre",
"middle_name": "",
"last_name": "Laurent",
"nickname": "Snochy"
},
"method": "logistics"
}
},
"payment": {
"payment_id": "NHF8736274",
"method": "card",
"channel": "paypal",
"amount": {
"currency": "USD",
"amount_local": 68,
"amount_usd": 10,
"amount_cny": 68
},
"card": {
"card_bin": "622207",
"last_four_digits": "1234",
"card_number_length": 16,
"holder_name": {
"first_name": "Pierre",
"middle_name": "",
"last_name": "Laurent",
"nickname": "Snochy"
},
"debit_or_credit": "credit",
"issuer_region": "CN",
"expiration_date": "1998-01-01"
},
"is_coupon_used": true,
"coupons": [
{
"coupon_id": "NOHF08938",
"coupon_name": "Limited Time Discount Coupon",
"coupon_count": 1,
"begin_time": 1596358039000,
"expire_time": 1616358039000,
"coupon_type": "discount",
"coupon_rate": 0.85,
"coupon_threshold": "10",
"cash_back_amount": {
"currency": "USD",
"amount_local": 6.8,
"amount_usd": 1,
"amount_cny": 6.8
}
}
]
},
"payment_result": {
"is_payment_success": true,
"payment_message": "success",
"is_3ds_used": false,
"response_by_3ds": {
"eci_value": "02",
"version": "2.2.0",
"authentication_type": "01",
"trans_status": "Y"
},
"response_by_avs": "",
"response_by_cvc": ""
},
"billing": {
"address": {
"country": "FR",
"region": "Grand Est",
"city": "Strasbourg City",
"district": "Ketali Lorem",
"detail": "3213 Building，lorem Street",
"zip_code": "310000"
},
"phone": {
"country_code": 1,
"phone_number": "18700001112"
},
"email": "hello@gmail.com",
"recipient": {
"first_name": "Pierre",
"middle_name": "",
"last_name": "Laurent",
"nickname": "Snochy"
}
},
"merchant": {
"merchant_id": "NFK00937",
"shop_name": "Hello World",
"shop_phone": {
"country_code": 1,
"phone_number": "18700001112"
},
"shop_email": "hello@gmail.com",
"shop_address": {
"country": "FR",
"region": "Grand Est",
"city": "Strasbourg City",
"district": "Ketali Lorem",
"detail": "3213 Building，lorem Street",
"zip_code": "310000"
},
"shop_url": "https://td/shop/0012",
"register_time": "2021-10-12T14:20:50.521+07:00",
"login_time": "2021-10-12T14:22:50.521+07:00",
"merchant_type": "entity",
"merchant_level": "A",
"company": "XXX",
"primary_category": "XXXX",
"product_count": 1,
"history_order_count": 1,
"history_order_amount": {
"currency": "USD",
"amount_local": 68,
"amount_usd": 10,
"amount_cny": 68
}
}
}API Status Code
{
"code": 200,
"message": "",
"sequence_id": "1648777165770866F82AC7F326307055",
"score": 90,
"result": "decline",
"reasons": [
{
"id": "IDZPQJEG",
"reason": "Suspicious purchasing patterns"
}
]
}