Fraud Management API

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.

• During order creation: This helps to effectively prevent fraudulent activities such as inventory hoarding.
• During order payment: It is advisable to send a risk verification request before performing the fund authorization on the payment gateway, or immediately after receiving the authorization response from the payment gateway but before actually capturing the funds. This ensures effective risk verification before any transactions take place.

API Format#

Base URL#

• China：https://cn-efficient.apitd.net/fraud/transaction/v3
• America：https://us-efficient.apitd.net/fraud/transaction/v3
• Singapore：https://sg-efficient.apitd.net/fraud/transaction/v3
• Germany：https://de-efficient.apitd.net/fraud/transaction/v3

API#

example: https://us-efficient.apitd.net/fraud/transaction/v3?partner_code=test_code&partner_key=test_key

Authentication

Request#

Request Example#

{
    "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"

Response Parameter#

API Status Code

Response Example#

{
    "code": 200,
    "message": "",
    "sequence_id": "1648777165770866F82AC7F326307055",
    "score": 90,
    "result": "decline",
    "reasons": [
        {
            "id": "IDZPQJEG",
            "reason": "Suspicious purchasing patterns"
        }
    ]
}