Anti-fraud simulator
We provide a simulator anti-fraud connection which can be used for integration testing. This anti-fraud connection makes it straight forward to test all response decisions and asynchronous webhooks.
Credentials
To configure the connection, you will need to set the following credentials.
| Credential | Description |
|---|---|
| API Key | This is not validated and can be set to any string |
Decision mapping
In order to test various anti-fraud decisions you must create a Gr4vy buyer with a
specific email address (see table below). If you do not pass a buyer with email address
the decision will be skipped.
| Buyer email | Gr4vy | Description |
|---|---|---|
accept@gr4vy.com | accept | Simulates a low risk transaction |
reject@gr4vy.com | reject | Simulates a high risk transaction |
review@gr4vy.com | review | Simulates a transaction which needs manual review |
error@gr4vy.com | error | Simulates a bad request |
timeout@gr4vy.com | exception | Simulates a server timeout/bad response |
Webhooks
In order to test the review status you can manually send a POST request to the
anti-fraud service webhook URL. You can find this value from the Gr4vy dashboard or via
the API when fetching the anti-fraud service.
GET /anti-fraud-services/{anti_fraud_service_id}
{
"type": "anti-fraud-service",
"id": "f80b5fc6-c95d-4a28-a929-4d5268c3e141",
"merchant_account_id": "default",
"display_name": "Simulator",
"anti_fraud_service_definition_id": "mock-anti-fraud",
"active": true,
"reviews_enabled": true,
"created_at": "2024-04-01T00:00:00+00:00",
"updated_at": "2024-04-01T00:00:00+00:00",
"webhook_url": "https://api.sandbox.example.gr4vy.app/i/af/-AtfxsldSiipKU1SaMPhQWZvcnRlci1hbnRpLWZyYXVk/5bOPmoOpwNRR6bKZaPD7MNjiZcYgSu1cNtNUO0jLUNc",
"fields": []
}
The expected POST body for the webhook URL must contain the UUID of the transaction and
a decision of ACCEPT or REJECT:
POST https://api.sandbox.example.gr4vy.app/i/af/-AtfxsldSiipKU1SaMPhQWZvcnRlci1hbnRpLWZyYXVk/5bOPmoOpwNRR6bKZaPD7MNjiZcYgSu1cNtNUO0jLUNc
{
"transactionId": "d6d2bc16-8a25-4e05-a595-b4cd51fe4932",
"decision": "ACCEPT" | "REJECT"
}
Device fingerprinting
Device fingerprinting is not currently supported via this connection.