2017 © Pedro Peláez
 

library signifyd

Signifyd driver for the Omnifraud PHP fraud prevention library

image

omnifraud/signifyd

Signifyd driver for the Omnifraud PHP fraud prevention library

  • Tuesday, May 29, 2018
  • by Korri
  • Repository
  • 3 Watchers
  • 0 Stars
  • 762 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 7 Versions
  • 84 % Grown

The README.md

Omnifraud: Signifyd

Signifyd driver for the Omnifraud PHP fraud prevention library, (*1)

Build Status Test Coverage, (*2)

Omnifraud is an fraud prevention livrary for PHP. It aims at providing a clear and consisten API for interacting with different fraud prevention service., (*3)

Installation

composer require omnifraud/signifyd

Usage

The Signifyd fraud service driver implements the following methods: trackingCode ,validateRequest, updateRequest, getRequestExternalLink, cancelRequest., (*4)

The only method that is left empty is logRefusedRequest as it is not a needed for Signifyd., (*5)

Initialisation

The SignifydService constructor accepts the following configuration values (these are the default values):, (*6)

$service = new KountService([
    'apiKey' => null, // Signifyd API key
    'caseUrl' => 'https://app.signifyd.com/cases/%d', // Url where cases are visible
    //... 
]);

NOTE: Anything supported by the official SignifydSettings class can be passed a config, (*7)

Submitting a sale

You can use the validateRequest to submit a request, method to get an async response that will need to be updated later., (*8)

Signifyd recommends sending as much fields as possible, take a look at this example to learn about all the fields., (*9)

getPayment()->setBin('1234');
// Etc... Anything provided in the request is sent to Signifyd, except the billing address phone number


// Send the request

$service = new \Omnifraud\Signifyd\SignifydService($serviceConfig);

$response = $service->validateRequest($request);

// Should always be true for a first request
if ($response->isPending()) {
    // Queue job for later update
}

```

#### Refreshing a case

Signifyd always answers with an Async response, so you will need to refresh the request in order to get the answer, this
is best done by queueing a job.

You can also use this method to get the request result later on (for example if you sent it for manual evaluation).

```php
$service = new \Omnifraud\Signifyd\SignifydService($serviceConfig);

$request = new \Omnifraud\Request\Request();
$request->setUid($requestUid);

$response = $service->updateRequest($request);

// Use for updating
$requestUid = $response->getRequestUid();

if ($response->isPending()) {
    // Retry later
    return;
}

$score = $response->getScore(); // Signifyd score divided by 10, 100 is best, 0 is worst
$guaranteed = $response->isGuaranteed(); // If covered by Signifyd guarantee

```

NOTE: The response from updateRequest can still be async, if this is the case, it means you have to retry later.


#### Cancelling a Guarantee

If you are refunding or cancelling an order, it is a good idea to cancel the guarantee as Signifyd will refund the fee.

```php
$service = new \Omnifraud\Signifyd\SignifydService($serviceConfig);

$request = new \Omnifraud\Request\Request();
$request->setUid($requestUid);

try {
    $service->cancelRequest($request);
} catch(\Omnifraud\Request\RequestException $e) {
    // Something went wrong
}
```

#### Session id (or [Device Fingerprint](https://www.signifyd.com/docs/api/#/reference/device-fingerprint))

You [implement the frontend code](https://github.com/lxrco/omnifraud#frontend-code) in order to track devices pre-purchase.

```

Then you will need to add the sessionId to the request:, (*10)

// Retrieve the session ID with some method, it can come from server side cookies/session also
$request->setSession($_COOKIE['sessionId']);

Linking to a case

In order to get the link to view a case on Signifyd, you just need the UID:, (*11)

$service = new \Omnifraud\Kount\KountService($serviceConfig);
$url = $service->getRequestExternalLink($requestUid);

The Versions

29/05 2018

dev-master

9999999-dev

Signifyd driver for the Omnifraud PHP fraud prevention library

  Sources   Download

MIT

The Requires

 

The Development Requires

by LXRandCo

29/05 2018

v0.3.0

0.3.0.0

Signifyd driver for the Omnifraud PHP fraud prevention library

  Sources   Download

MIT

The Requires

 

The Development Requires

by LXRandCo

03/04 2018

v0.1.4

0.1.4.0

Signifyd driver for the Omnifraud PHP fraud prevention library

  Sources   Download

MIT

The Requires

 

The Development Requires

by LXRandCo

23/03 2018

v0.1.3

0.1.3.0

Signifyd driver for the Omnifraud PHP fraud prevention library

  Sources   Download

MIT

The Requires

 

The Development Requires

by LXRandCo

22/03 2018

v0.1.2

0.1.2.0

Signifyd driver for the Omnifraud PHP fraud prevention library

  Sources   Download

MIT

The Requires

 

The Development Requires

by LXRandCo

22/03 2018

v0.1.1

0.1.1.0

Signifyd driver for the Omnifraud PHP fraud prevention library

  Sources   Download

MIT

The Requires

 

The Development Requires

by LXRandCo

21/03 2018

v0.1.0

0.1.0.0

Signifyd driver for the Omnifraud PHP fraud prevention library

  Sources   Download

MIT

The Requires

 

The Development Requires

by LXRandCo