• No results found

BliBli - Integration Guide.pdf

N/A
N/A
Protected

Academic year: 2021

Share "BliBli - Integration Guide.pdf"

Copied!
8
0
0

Loading.... (view fulltext now)

Full text

(1)

Customer Name

Customer Name

BliBli 

BliBli 

Make a free account

Make a free account

Payment Abuse

Payment Abuse

https://siftscience.com/signup

https://siftscience.com/signup

1 week: Testing phase

1 week: Testing phase

Test data in Sandbox account 

Test data in Sandbox account 

Send REST API events (details on "User Flow" sheet)

Send REST API events (details on "User Flow" sheet)

https://siftscience

https://siftscience

.com/develo

.com/develo

pers/docs/cur

pers/docs/cur

l/events-api

l/events-api

Install the JS snippet for all web traffic

Install the JS snippet for all web traffic

https://siftscience

https://siftscience

.com/develo

.com/develo

pers/docs/java

pers/docs/java

script/javascr

script/javascr

ipt-api

ipt-api

Sync before going live

Sync before going live

Send full live data to

Send full live data to Sandbox API Keys

Sandbox API Keys

Sift will take a

Sift will take a look, confirm data values look good.

look, confirm data values look good.

"Go live"

"Go live"

Switch data to

Switch data to Production account 

Production account 

Send feedback to Sift through Decisions API and console

Send feedback to Sift through Decisions API and console

https://siftscience

https://siftscience

.com/develo

.com/develo

pers/docs/cur

pers/docs/cur

l/decisions-a

l/decisions-a

pi/overview

pi/overview

(optional) Backfill data for previous 3 months

(optional) Backfill data for previous 3 months

https://siftscience

https://siftscience

.com/resourc

.com/resourc

es/tutorials/sen

es/tutorials/sen

ding-histo

ding-histo

rical-data

rical-data

Client Libraries

Client Libraries

Java

(2)

Integration

Phase

User

action

Sift

API

Event

Comments

Creates

account

$create_account

Updates account details

$update_account

Send updated fields only

 After user attempts to checkout but before

charging the payment method

$create_order  

The result for charging the payment method

$transaction

User changes order details

$update_order

Send ALL order details sent previously

User

logs-in

$login

(3)

Event: $create_account/$update_account Key complete https://siftscience.com/developers/docs/curl/events-api/reserved-events/create-account m missing

incomplete/incorrect

Use Synchronous Workflows? No n/a not available

Field Type Sample Status Siftcomments BliBlicomments

$user_id string

$session_id string m not sent to backend microservice that create/update the user  

$user_email string

$ip string "192.168.1.1" m not sent to backend microservice that create/update the user  

$name string notavailableduringcreate-avaliableonupdate

$phone string "+1-415-555-2323" not available during create - avaliable on update

$payment_methods [ ] array on update, can be available only if the user opt to save their cc token w blibli

  $payment_type enum e.g "$credit_card"

  $payment_gateway  enum e.g "$stripe" we have two: http://speedorder.asia/2016/, https://midtrans.com/

  $card_bin string first 6 digits "123456" received by blibli after payment is done on payment gateway side

  $card_last4 string last 4 digits "6789" received by blibli after payment is done on payment gateway side

$billing_address { } address can be edited when making an order, we use the default address as billing address.

  $name string

  $address1 string

  $city  string

  $region string m In Indonesia: Contry -> Province -> City -> District -> Sub-district

  $country  string 2-letter country code "US", "ES"

  $phone string "+1-415-555-2323"

$zipcode string zipcodeistiedtoasubdistrict

$shipping_address thedefaultaresetasbillingaddress

$name string

  $address1 string

  $city  string

  $region string m

  $country  string 2-letter country code "US", "ES"

  $phone string "+1-415-555-2323"

  $zipcode string

(4)

Event: $create_order/$update_order Key complete

https://siftscience.com/developers/docs/curl/events-api/reserved-events/create-order  m missing

incomplete/incorrect

Use Synchronous Workflows? No n/a not available

Field Type Sample Status Siftcomments BliBlicomments

$user_id string

$session_id string m Same on account create/update. see account create/update

$order_id string "12345"

$user_email string

$ip string "192.168.1.1" for this one I think its available, we use it for our in house rule based fraud system

$amount int in micros e.g $1 = 1000000

$currency_code string "USD"

$shipping_address

  $name string

  $address1 string

  $city  string

  $region string m seeaccountcreate/update

  $country  s tr in g 2 -l et te r c ou nt ry co de "U S" , " ES "

  $phone string "+1-415-555-2323"

  $zipcode string seeaccountcreate/update

$billing_address { } address

  $name string

  $address1 string

  $city  string

  $region string m seeaccountcreate/update

  $country  s tr in g 2 -l et te r c ou nt ry co de "U S" , " ES "

  $phone string "+1-415-555-2323"

$zipcode string

$items [ ] array TODO: check list of the whole reserved items

  $item_id  string

  $product_title string

  $price int in micros e.g $1 = 1000000

  $currency_code string MXN, USD, CAD, EUR

  $quantity  int

  $brand  string

  $category  string

  $tags string [ ] [fashion, shoes] m what is example for this data?

  $size string

If it's avaliable, you can use this. However, if the product doesn't

have this field, it can be removed. not all product has this, we use free text for this field, merchant can put almost anything

$payment_methods [ ] array

  $payment_type enum e.g "$credit_card", "points", "store_credit"

  $payment_gateway  enum e.g"$paypal" seeaccountcreate/update

  $card_bin string first 6 digits "123456" see account create/update

  $card_last4 string last 4 digits "6789" see account create/update

$promotions [ ] promotion [ ]

  $promotion_id  string e.g "COUPON140"

  $description s tr ing e. g p ro mo co de " $15 of f"

$seller_user_id string m in blibli each order-item can be from different seller, it should be a field inside the "item" document

$expedited_shipping bool

Custom Fields

channel string web/ios/android

traffic_source string direct, google, facebook.com

traffic_medium string organic, cpc, direct, referral

(5)

Event:$transaction Key complete https://siftscience.com/developers/docs/curl/events-api/reserved-events/transaction m missing

incomplete/incorrect Use Synchronous Workflows? No n/a not available

Field Type Comments Status Sift comments BliBli comments $user_id string

$order_id string "12345" $transaction_id string "12345"

$transaction_type enum e.g $sale/$void/$refund/$auth/$capture $transaction_status enum $success/$failure/$pending $amount int in micros e.g $1 = 1000000 $currency_code string "USD"

$user_email string $billing_address { } address   $name string   $address1 string   $city  string

  $region string m seeaccountcreate/update

  $country  string 2-letter country code "US", "ES"

  $zipcode string m

  $phone string "+1-415-555-2323" $payment_method { }

  $payment_type enum e.g "$credit_card"

  $payment_gateway  enum e.g"$stripe" seeaccountcreate/update   $card_bin string first 6 digits "123456" see account create/update   $card_last4 string last 4 digits "6789" see account create/update

  $cvv_result_code string m need to check if we get this or not from payment gateway   $avs_result_code string m need to check if we get this or not from payment gateway

$session_id string m is this the same session id from browser session_id?, the transaction update can come from backend system of payment gateway, not via browser. Custom Fields

(6)

Event:

$login

/

$logout

Key

complete

https://siftscience.com/developers/docs/curl/events-api/reserved-events/login

m

missing

incomplete/incorrect

Use Synchronous Workflows?

No

n/a

not available

Field

Type Sample

Status

Sift

comments

BliBli

comments

$ip

string "192.168.1.1"

m

see

account

create/update

$user_id

string

$session_id

string

m

see

account

create/update

$login_status ($login only)

enum "$success", "$failure"

$browser 

  $user_agent 

string

m

not

sent

to

backend

microservice

that

validate

login

$app

n/a

we

won't

be

doing

app

for

the

trial

$os

string

n/a

  $os_version

string

n/a

  $device_manufacturer 

string

n/a

  $device_model 

string

n/a

  $device_unique_id 

string

n/a

  $app_name

string

n/a

(7)

Steps

Notes

Create Decisions in Console

https://siftscience.com/resources/tutorials/decisions#create-decisions

Configure Webhooks for Decisions

https://siftscience.com/resources/tutorials/decisions#connecting-decisions

Send Decisions at appropriate times via API https://siftscience.com/developers/docs/curl/decisions-api/apply-decisions

(8)

Decisions

https://siftscience.com/resources/tutorials/decisions#create-decisions

Decisions to be configured in the Sift Console

Decision

Name

Decision

ID

Abuse

Type

Category

Entity

Webhook

URL

Looks Bad - Known Fraudster

looks_bad_known_fraudster

Payment Abuse

Block

User  

Looks Bad - Stolen Credit Card

looks_bad_bad_cc

Payment Abuse

Block

User  

Looks Good - Employee

looks_good_employee

Payment Abuse

Accept

User  

When to send a decision via API

Business

Decision

Decision

ID

Source

Block a known fraudster returning

looks_bad_known_fraudster

MANUAL_REVIEW

Block a user using a bad credit card looks_bad_bad_cc

MANUAL_REVIEW

References

Related documents

Jones  Centr e for Quantum Computation, Clar endon L ab or atory, University of Oxfor d, Parks R o ad, O X1 3PU, Unite d Kingdom (Dated: Jan uary 29, 2003) W e describ e the use

Be it noted that the registration of the sale in favor of the second purchaser and the issuance of a new certifi cate of title in his favor does not in any manner vest in him

Timber structures are analysed using elastic structural analysis techniques in ultimate & serviceability limit states. Thus whilst the ULS loading is adopted as per EC5,

Accordingly, this study is conducted to re-examine an intercultural competence model developed by Deardorff in 2004 by exploring the nature of

ideology, but with philosophy, which is based on an interest in finding ways of ideology, but with philosophy, which is based on an interest in finding ways

Property Data Type yearNames structure stockNames structure stockReturn matrix (double) S&PReturns array (double) Probabilities array (double) MinReturnLowerBound

A subgrid-scale model is presented for the scalar dissipation rate in nonpremixed turbulent reacting flows.. Inputs to the model are the filtered density, the Favre-

Where participants will have the opportunity to solve pre-defined cases of various physic, likes: Potential flow, Simple fluid flows, Heat Transfer including natural