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.
Sending Queries
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.
https://app.subuno.com/transaction/EPIM7XNYZU
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
Query Response
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).
Subuno API Inputs
The Subuno API requires a valid license key and at least one input. Sending more information will allow you take advantage of more rule settings and fraud prevention tools.
Query Response
Subuno license key (apikey)
Your Subuno API license key.
Platform information (source)
How information is sent to Subuno. Please put “API” as your source.
Order Information
Transaction ID (t_id)
Your internal transaction ID.
IP address (ip_addr)
IP address of the customer.
Total price (price)
Total price of the transaction.
Bank Identification Number (iin)
The first six digits of the customer’s credit card which identifies the issuing ban.
AVS response (avs_response)
AVS response code returned by your processor.
CVV response (cvv_response)
CVV response code returned by your processor.
Issuer phone number (issuer_phone)
The customer service number of the issuing bank of the credit card used.
Billing Information
Customer name (customer_name)
First and last name of the customer.
Phone number (phone)
Phone number of the customer.
E-mail (email)
E-mail address of the customer.
Company (company)
Customer’s company/organization.
Billing address 1 (bill_street1)
Line 1 of the billing address.
Billing address 2 (bill_street2)
Line 2 of the billing address.
Billing city (bill_city)
City of the billing address.
Billing state/region (bill_state)
State of the billing address.
Billing country (bill_country)
The two digit country code of the billing country.
Billing zip/postal code (bill_zip)
The zip code or the postal code of the billing address.
Shipping Information
Recipient’s name (ship_name)
First and last name of the recipient.
Recipient’s phone number (ship_phone)
Phone number of the recipient.
Recipient’s e-mail (ship_email)
E-mail address of the recipient.
Shipping address 1 (ship_street1)
Line 1 of the shipping address.
Shipping address 2 (ship_street2)
Line 2 of the shipping address.
Shipping city (ship_city)
City of the shipping address.
Shipping state/region (ship_state)
State of the shipping address.
Shipping country (ship_country)
The two digit country code of the shipping country.
Shipping zip/postal code (ship_zip)
The zip code or the postal code of the shipping address.
Additional Information
Custom field 1 (custom1)
Character field (max 100) for passing additional information not previously defined.
Custom field 2 (custom2)
Character field (max 100)for passing additional information not previously defined.
Custom field 3 (custom3)
Character field (max 100)for passing additional information not previously defined.