Bayonet enables companies to feed and consult a global database about online consumersâ reputation, based on historic payments. Start making smarter business decisions today., (*2)
Bayonetâs API is organized around REST and exposes endpoints for HTTP requests. It is designed to have predictable, resource-oriented URLs and uses standard HTTP response codes to indicate the outcome of operations. Request and response payloads are formatted as JSON., (*3)
Bayonet provides an Ecosystem of Trust and Protection where companies can collaborate with each other to combat online fraud together. We provide a secure platform to share and consult data to understand when a consumer is related to fraudulent activity or has a fraud-free record. Different technologies that run algorithms to link parameters seen in different transactions, fed by companies connected to the ecosystem are employed in order to build consumer profiles. By consulting Bayonetâs API, a response with data provided by companies themselves is available in real-time for your risk assesment process to analyze it and take better decisions., (*4)
The examples shown in this README are only for demonstration of the functionality of this SDK. For the detailed integration flow, and when to send which API call, please refer to the Bayonet API documentation., (*5)
To use this SDK, please make sure:
* You have PHP 5.4 or superior installed on your system.
* You have an API KEY (sandbox and/or live) provided by Bayonet's team., (*6)
Once you have Bayonet's SDK configured, you can call the APIs with the following syntax. Follow the guidelines specific to the product you are integrating:, (*13)
-
Initialize the Ecommerce client, (*16)
$bayonet = new Bayonet\EcommerceClient([
'api_key' => 'your_api_key',
'version' => 2
]);
You can use environment vars to load the api key too, (*17)
export BAYONET_API_KEY=your_api_key
-
Consult API, (*18)
$bayonet->consult([
'body' => [
'channel' => 'ecommerce',
'email' => 'example@bayonet.io',
'consumer_name' => 'Example name',
'consumer_internal_id' => '<your internal ID for this consumer>',
'cardholder_name' => 'Example name',
'telephone' => '1234567890',
'card_number' => '4111111111111111',
'transaction_amount' => 999.00,
'currency_code' => 'MXN',
'shipping_address' => [
'line_1' => 'example line 1',
'line_2' => 'example line 2',
'city' => 'Mexico City',
'state' => 'Mexico DF',
'country' => 'MEX',
'zip_code' => '64000'
],
'billing_address' => [
'line_1' => 'example line 1',
'line_2' => 'example line 2',
'city' => 'Mexico City',
'state' => 'Mexico DF',
'country' => 'MEX',
'zip_code' => '64000'
],
'payment_method' => 'card',
'order_id' => '<your internal ID for this order>',
'transaction_id' => '<your internal ID for this transaction>',
'payment_gateway' => 'stripe',
'coupon' => 'discount_buen_fin',
'expedited_shipping' => true,
'products' => [
[
'product_id' => '1',
'product_name' => 'product_1',
'product_price' => 500.00,
'product_category' =>'example category'
],
[
'product_id' => '2',
'product_name' => 'product_2',
'product_price' => 499.00,
'product_category' =>'example category'
]
],
'bayonet_fingerprint_token' => '<token generated by Bayonet fingerprinting JS>'
],
'on_success' => function($response) {
print_r($response);
},
'on_failure' => function($response) {
print_r($response);
}
]);
-
Update Transaction API, (*19)
$bayonet->update_transaction([
'body' => [
'transaction_status' => 'success',
'transaction_id' => '<your internal ID for this transaction (as sent in the consult step)>',
...
],
'on_success' => function($response) {
print_r($response);
},
'on_failure' => function($response) {
print_r($response);
}
]);
-
Feedback-historical API, (*20)
$bayonet->feedback_historical([
'body' => [
'channel' => 'ecommerce',
'email' => 'example@bayonet.io',
'consumer_name' => 'Example name',
'consumer_internal_id' => '<your internal ID for this consumer>',
'cardholder_name' => 'Example name',
'telephone' => '1234567890',
'card_number' => '4111111111111111',
'transaction_amount' => 999.00,
'currency_code' => 'MXN',
'shipping_address' => [
'line_1' => 'example line 1',
'line_2' => 'example line 2',
'city' => 'Mexico City',
'state' => 'Mexico DF',
'country' => 'MEX',
'zip_code' => '64000'
],
'billing_address' => [
'line_1' => 'example line 1',
'line_2' => 'example line 2',
'city' => 'Mexico City',
'state' => 'Mexico DF',
'country' => 'MEX',
'zip_code' => '64000'
],
'payment_method' => 'card',
'transaction_id' => '<your internal ID for this transaction>',
'payment_gateway' => 'stripe',
'coupon' => 'discount_buen_fin',
'expedited_shipping' => true,
'products' => [
[
'product_id' => '1',
'product_name' => 'product_1',
'product_price' => 500.00,
'product_category' =>'example category'
],
[
'product_id' => '2',
'product_name' => 'product_2',
'product_price' => 499.00,
'product_category' =>'example category'
]
],
'bayonet_fingerprint_token' => '<token generated by Bayonet fingerprinting JS>',
'transaction_time' => 1476012879,
'transaction_status' => 'success',
],
'on_success' => function($response) {
print_r($response);
},
'on_failure' => function($response) {
print_r($response);
}
]);
-
Initialize the Lending client, (*21)
php
$bayonet = new Bayonet\LendingClient([
'api_key' => 'your_api_key',
'version' => 2
]);
You can use environment vars to load the api key too, (*22)
sh
export BAYONET_API_KEY=your_api_key, (*23)
-
Report Transaction (Request for loan received), (*24)
$bayonet->report_transaction([
'body' => [
'email' => 'example@bayonet.io',
'consumer_name' => 'Example name',
'consumer_internal_id' => '<your internal ID for this consumer>',
'telephone_fixed' => '1234567890',
'telephone_mobile' => '1234567891',
'telephone_reference_1' => '1234567892',
'telephone_reference_2' => '1234567893',
'telephone_reference_3' => '1234567894',
'rfc' => 'Example RFC',
'curp' => 'Example CURP',
'clabe' => 'Example CLABE',
'address' => [
'line_1' => 'example line 1',
'line_2' => 'example line 2',
'city' => 'Mexico City',
'state' => 'Mexico DF',
'country' => 'MEX',
'zip_code' => '64000'
],
'bayonet_fingerprint_token' => '<token generated by Bayonet fingerprinting JS>',
'transaction_category' => 'p2p_lending',
'transaction_id' => '<your internal ID for this transaction>',
'transaction_time' => 1476012879
],
'on_success' => function($response) {
print_r($response);
},
'on_failure' => function($response) {
print_r($response);
}
]);
-
Report Transaction (Request for loan received) + Consult, (*25)
This lets you report a transaction (solicitud) and consult Bayonet at the same time. The only difference from the above method (Report Transaction) is that this method will also return a consult response, (*26)
$bayonet->report_transaction_and_consult([
'body' => [
'email' => 'example@bayonet.io',
'consumer_name' => 'Example name',
'consumer_internal_id' => '<your internal ID for this consumer>',
'telephone_fixed' => '1234567890',
'telephone_mobile' => '1234567891',
'telephone_reference_1' => '1234567892',
'telephone_reference_2' => '1234567893',
'telephone_reference_3' => '1234567894',
'rfc' => 'Example RFC',
'curp' => 'Example CURP',
'clabe' => 'Example CLABE',
'address' => [
'line_1' => 'example line 1',
'line_2' => 'example line 2',
'city' => 'Mexico City',
'state' => 'Mexico DF',
'country' => 'MEX',
'zip_code' => '64000'
],
'bayonet_fingerprint_token' => '<token generated by Bayonet fingerprinting JS>',
'transaction_category' => 'p2p_lending',
'transaction_id' => '<your internal ID for this transaction>',
'transaction_time' => 1476012879
],
'on_success' => function($response) {
print_r($response);
},
'on_failure' => function($response) {
print_r($response);
}
]);
-
Consult (consult the persona present in the transaction), (*27)
$bayonet->consult([
'body' => [
'transaction_id' => '<transaction ID that you used when reporting the transaction or solicitud>'
],
'on_success' => function($response) {
print_r($response);
},
'on_failure' => function($response) {
print_r($response);
}
]);
-
Feedback (send feedback regarding a transaction - raise alert or block the user), (*28)
$bayonet->feedback([
'body' => [
'transaction_id' => '<transaction ID that you used when reporting the transaction or solicitud>',
'actions' => [
'alert' => true,
'block' => true
]
],
'on_success' => function($response) {
print_r($response);
},
'on_failure' => function($response) {
print_r($response);
}
]);
-
Feedback historical (for reporting historical transactions that were not sent to Bayonet), (*29)
php
$bayonet->feedback_historical([
'body' => [
'email' => 'example@bayonet.io',
'consumer_name' => 'Example name',
'consumer_internal_id' => '<your internal ID for this consumer>',
'telephone_fixed' => '1234567890',
'telephone_mobile' => '1234567891',
'telephone_reference_1' => '1234567892',
'telephone_reference_2' => '1234567893',
'telephone_reference_3' => '1234567894',
'rfc' => 'Example RFC',
'curp' => 'Example CURP',
'clabe' => 'Example CLABE',
'address' => [
'line_1' => 'example line 1',
'line_2' => 'example line 2',
'city' => 'Mexico City',
'state' => 'Mexico DF',
'country' => 'MEX',
'zip_code' => '64000'
],
'bayonet_fingerprint_token' => '<token generated by Bayonet fingerprinting JS>',
'transaction_category' => 'p2p_lending',
'transaction_id' => '<your internal ID for this transaction>',
'transaction_time' => 1476012879,
'actions' => [
'alert' => true,
'block' => true
]
],
'on_success' => function($response) {
print_r($response);
},
'on_failure' => function($response) {
print_r($response);
}
]);, (*30)
Wallogit.com
