Welcome to the Subuno API
This documentation will show how to use the Subuno API. For merchants using Yahoo Stores, Shopify, or BigCommerce, installation takes a few minutes and does not require the Subuno API. We also have a plugin for Woocommerce. For other shopping cart users (e.g. Magento, osCommerce, PrestaShop, etc.) available, modules developed by third parties may be availalble. Please contact us for more details.
The Subuno API sends order information and receives an “Accept/Reject/Manual Review” response based on the rules and settings of your account. Sample libraries to call the API are available in Java, PHP, Python, .NET, and Ruby. Visit our Github Page for more details.
Queries are made through GET requests. Each query must contain your Subuno API key and at least one transaction data field. While you are welcome to send Subuno as many (or as few) fields as possible, sending more fields to Subuno will ensure that all your customized rules are run properly, thereby returning to you a more accurate risk profile based on your rules.
This query sends a Subuno license key, billing zip code, IP address, and order number to Subuno.
Responses from queries
Responses are serialized in JSON and include an action flag (accept, reject or manual review) based on your setting, a unique reference code, your merchant order (if it was sent as part of the query). You may use the reference code to access that particular order within Subuno to see the complete details.
Order status update
When an order’s status changes during manual review (i.e. changing an order marked for review to either accept or reject), an order status webhook automatically sends a status update to a designed URL. To identify the transaction, the reference code (ref_code) and your order id (t_id), if provided, will be included in the webhook. You may specify the designation in your settings.
This query the order number, reference code, and updated action to URL example. Order status changed from review to accept.
Subuno API Outputs
Action flag (action)
The action flag (accept, reject or review) determined by the business rules for your account.
Reference ID (ref_code)
Subuno generated unique ID for each transaction.
Transaction ID (t_id)
Your internal transaction ID (if sent as an input).