Domain

Ravelin recommends whether you should accept, challenge, or prevent payments from customers.

In assessing each customer, Ravelin will look at their identity, prior orders, transactions/payment attempts, cards/payment methods, and where they are ordering from. It is important that you send the data to Ravelin cleanly to paint a full, accurate picture from which to attain good fraud prevention results.

When considering this information, it is important that Ravelin has as much of this data as possible before being asked to score a customer in order for us to make a fully-informed recommendation.

Customers

A customer places many orders, attempts many transaction payments, spends on many payment methods, logs in from many devices, and files many chargebacks. If customers are not required to sign up to your website/app in order to make a purchase, we recommend using their email address as the customerId in all cases.

Customer information should be sent to Ravelin when:

Orders

An order is placed by one customer, has a price and currency, has many order items describing what is being bought, may have multiple failed transaction payments, hopefully has a successful transaction payment, is placed from one device, and has disputing chargebacks. The multiple order items may describe cab rides, food orders, concert tickets, hotel bookings, something else, or some combination of each.

Order information should be sent to Ravelin when the customer has shown intent to purchase:

  • the customer adds or removes items to the basket (/v2/order)
  • the customer selects the journey they are about to take (/v2/order)
  • the customer clicks “Pay Now” from the checkout page (/v2/checkout?score=true)
  • the customer has been told their order is accepted or complete (/v2/order)
  • the customer cancels or is told their order has been cancelled (/v2/order)

and generally progress through pending (pre-scoring), accepted (passed fraud check; merchant intends to fulfill), into fulfilled, cancelled, or failed.

Transactions

A transaction is an attempt to pay for one order placed by one customer, has an amount and a currency, has one payment method and gateway processor, eventually has a gateway reference, success flag and authentication/check information, and may have multiple chargebacks associated with it. A transaction spans one attempt to pay by one customer.

Transaction information should be sent to Ravelin when:

Payment Methods

A payment method is used by one customer to provide funds to fulfill many transactions and many orders. The payment method can be a payment card (having a scheme, issuer, BIN, last-four digits, and a globally-identifying instrumentID), a voucher, cash, PayPal account, or many other means of sending funds.

Payment method information should be sent to Ravelin when:

Chargebacks

A chargeback is a dispute filed by a cardholder with their card issuer to say that they believe a charge against their card to have been conducted without their consent. Chargebacks have an amount (usually the disputed transaction amount plus a penalty), a currency, and an originating payment method, transaction and customer. For fraudulent chargebacks, the customer will not usually be the real cardholder.

See Ravelin’s chargeback guide for more.