Tiwala

Building a community of trust
between business and consumers.

Home Log In

API alpha

POST transactions/add

Creates a new transaction to merchants verification queue. This will trigger a SMS to be sent to consumers mobile to verify transaction. Response also returns customer risk analysis taken from our multi-tenanted database.

Resource URL

POST http://tiwala.co/transactions/add.json?token=API_TOKEN

Parameters

Name Required Data Type Description
order_id required string This is your merchant reference number for tracking purposes.
mobile required numeric Customer mobile phone number used to send confirmation SMS and identify customers.
price required decimal Total cost of transaction (including shipping price)
deposit required integer Deposit amount. Between 1 and 100 Rs.
firstname optional string Customers first name used for identification and cross referencing of risk.
lastname optional string Customers last name used for identification and cross referencing of risk.
address optional string Shipping address of the transaction used to cross reference risk of location.
postal_code optional string Zip code of shipping address used to cross reference risk of location.
country_id optional integer Country of shipping address, Please see our list of countries and their ID's Here. Used to route SMS and identify risk of country.
payment_method_id optional integer Payment method of transaction. Please see our list of supported payment methods here. Used to identify risk of payment.

Example request

curl http://tiwala.co/transactions/add.json?token=API_TOKEN \
    -d "order_id=4494" \
    -d "mobile=910000000000" \
    -d "price=39.90" \
    -d "deposit=50" \
    -d "firstname=John" \
    -d "lastname=Smith" \
    -d "address=123 street name" \
    -d "postal_code=40001" \
    -d "country_id=10" \
    -d "payment_method_id=1"

Example response

{
    "success":true,
    "data":
    {
        "id":"100",
        "order_id":"4494",
        "mobile":910000000000,
        "price":39.90,
        "deposit":50,
        "firstname":"John",
        "lastname":"Smith",
        "address":"123 street name",
        "postal_code":"4001",
        "country_id":10,
        "payment_method_id":1,
        "risk":"50",
        "verified":0,
        "verified_date":null
    }
}