Markdownをコピー
Siftイベント連携
POST/payment/SiftEvents.idPass
Siftイベント連携APIです。
イベントタイプ(Type)により4つの機能を提供します。
$create_order: 決済前スコア判定$transaction: 決済後スコア判定$chargeback: チャージバック情報連携$decision: 取引判断結果連携
$transaction: 決済後スコア判定について
-
UserIdより下のパラメータは決済前スコア判定($create_order)の値を自動で設定し、Siftへ送信します。
決済前スコア判定で値を設定していない場合、または違う値を送信したい場合はパラメータを設定してください。 -
オーダーID、決済手段を指定した場合、取引の情報を取得し自動で設定されます。
表：決済手段ごとの自動設定パラメータ
| 決済手段 | 設定されるパラメータ | 設定値 |
|---|---|---|
| 共通 | 金額（Amount) | 取引の金額が設定されます。 |
| 共通 | 通貨コード（CurrencyCode) | JPYが設定されます。 |
| 共通 | 取引ステータス（TransactionStatus) | 取引の現状態を基に設定されます。成功：$success / 失敗：$failure / 上記以外：$pending |
| Credit | 銀行識別番号（PayMethod.CardBin) | 取引のカード番号が設定されます。 |
| Credit | カード番号下四桁（PayMethod.CardLast4) | 取引のカード番号が設定されます。 |
| Credit | 取引区分（TransactionType) | 取引の処理区分を基に設定されます。SALES：$sale / AUTH：$authorize / CAPTURE：$capture / VOID：$void |
| Credit | 支払い方法（PaymentType) | $credit_cardが設定されます。 |
| Cvs | ユーザメールアドレス（UserEmail) | 取引の結果通知先メールアドレスが設定されます。 |
| Cvs | 氏名（BillingAddress.Name) | 取引の氏名が設定されます。 |
| Cvs | 電話番号（BillingAddress.Phone) | 取引の電話番号が設定されます。 |
| Dcc | 通貨コード（CurrencyCode) | 取引の通貨コードが設定されます。 |
| Dcc | 銀行識別番号（PayMethod.CardBin) | 取引のカード番号が設定されます。 |
| Dcc | カード番号下四桁（PayMethod.CardLast4) | 取引のカード番号が設定されます。 |
| Dcc | 支払い方法（PaymentType) | $credit_cardが設定されます。 |
| AuContinuance | 金額（Amount) | 取引の初回決済金額が設定されます。 |
| Unionpay | 支払い方法（PaymentType) | $credit_cardが設定されます。 |
リクエストパラメータ
$create_order(決済前スコア判定)
ShopID=tshop11223344&ShopPass=PASSWORD&Type=$create_order&UserId=billy_jones_301&SessionId=gigtleqddo84l8cm15qe4il&OrderID=ORDER0000001&UserEmail=bill@gmail.com&Amount=1000000000&CurrencyCode=USD&BillingAddress_Name=Bill Jones&BillingAddress_Address1=2100 Main Street&BillingAddress_Address2=Apt 3B&BillingAddress_City=New London&BillingAddress_Region=New Hampshire&BillingAddress_Country=US&BillingAddress_Zipcode=03257&BillingAddress_Phone=1-415-555-6041&PaymentMethods_PaymentType=$credit_card&PaymentMethods_CardBin=542486&PaymentMethods_CardLast4=4444&ShippingAddress_Name=Bill Jones&ShippingAddress_Address1=2100 Main Street&ShippingAddress_Address2=Apt 3B&ShippingAddress_City=New London&ShippingAddress_Region=New Hampshire&ShippingAddress_Country=US&ShippingAddress_Zipcode=03257&ShippingAddress_Phone=1-415-555-6041&ExpeditedShipping=true&ShippingMethod=$physical&Items_ItemId=12344321&Items_ProductTitle=Microwavable Kettle Corn: Original Flavor&Items_Price=4990000000&Items_CurrencyCode=JPY&&Items_Quantity=1&Items_Upc=097564307560&Items_Sku=03586005&Items_Brand=Peters Kettle Corn&Items_Manufacturer=Peters Kettle Corn&Items_Category=Food and Grocery&Items_Tags=Popcorn&SellerUserId=slinkys_emporium&Promotions_PromotionId=FirstTimeBuyer&Promotions_Status=$success&Promotions_Description=$5 off&Promotions_Discount_Amount=5000000&Promotions_Discount_CurrencyCode=USD&Promotions_Discount_MinimumPurchaseAmount=25000000&Browser_UserAgent=Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36
$transaction(決済後スコア判定)
ShopID=tshop11223344&ShopPass=PASSWORD&Type=$transaction&OrderID=ORDER0000001&PayType=Credit
$chargeback(チャージバック情報連携)
ShopID=tshop11223344&ShopPass=PASSWORD&Type=$chargeback&ChargebackState=$lost&ChargebackReason=$duplicate&SiftOrderID=20200101-de267b90-fe9c-4736-9de2-9bf6528aa41a3
$decision(取引判断結果連携)
ShopID=tshop11223344&ShopPass=PASSWORD&Type=$decision&DecisionId=order_looks_bad_payment_abuse&Source=MANUAL_REVIEW&Analyst=analyst@example.com&Description=User linked to three other payment abusers and ordering high value items&SiftOrderID=20200101-de267b90-fe9c-4736-9de2-9bf6528aa41a
Request
Responses
- 200
SiftEventsレスポンス
※idPass版では Example (auto) のサンプルは使用できません。 json版でのみ利用可能です。