Menu

Developer Resources

Manual Review

Our patented, AI and Machine Learning driven fraud detection platform is amazing, and our people are just as amazing – we give them access to tools that help them develop insights that a machine might miss or can’t read. Manual Review allows Vesta to put some of your orders into the hands of this staff of experts to help save some safe transactions that may initially look high risk, further increasing your bottom line.

When a transaction meets certain high-risk criteria, we tell you that it is Pending for Manual Review. You hold fulfillment for a small period and listen for the final decision on a URL. When our people see that it is safe, we let you know with a push-update to that URL and you fulfill the order. When it looks bad, the push-update tells you that too. In the end, you can get even more orders shipping to good customers.

The following flow illustrates the processes within the Pending with Manual Review method:

Integration to Pending with Manual Review is simple. All you must do is:

  • Tell us you want it.
  • Ensure you are set up to delay fulfillment and deliver the right messaging when a transaction is pended by this method.
    • When this happens, the response to your API Call will include the following:

      PaymentStatus = 2

      PendResolutionMethods = 20,{}

  • Set up your messaging to tell your customers when the order is pending. We have some suggestions in the Best Practices.

  • You can enter your URL to which we should send the final decision in the Portal Account Info option. Of course, we need the login credentials, too.
    • The parameters passed to this URL will include:

      {PendResolutionMethod=20, // 20 indicates Manual Review

      RiskProbabilityIndex=2, // A value 1-5

      IsPaymentGuaranteeable=0, // Boolean 0 or 1

      PaymentID= 1U3BWY, // This order’s PaymentID

      PaymentStatus=10, // A code, indicating the decision

      TransactionID=123 // This order’s TransactionID

      AccountName=youraccount,

      Password=yourpassword}

      Depending on your product, your final decision may be indicated by either IsPaymentGuaranteeable or PaymentStatus.

    • Fulfillment should be delayed until you get this final decision.