Order API - Order Tracking
Order API Specifications - Order Tracking
This API is used for order data postback. Once the purchase is done and API gets called, ShopBack will receive the data and keep it in the system with a pending status for further validation.
As a general rule for ShopBack APIs, all parameter values must be URL-encoded to prevent read errors.
GET URL: http://shopback.go2cloud.org/aff_lsr
| Parameter Name | Parameter Value | Parameter Example | Description | Format | Required |
|---|---|---|---|---|---|
| offer_id | {order_offer_id} | Fixed merchant id. Please obtain this value from your ShopBack representative. | numeric | mandatory | |
| adv_sub | { customer_facing_order_id } | Customer-facing order id | alphanumeric | mandatory | |
| adv_sub2 | optional | ||||
| adv_sub3 | optional | ||||
| adv_sub4 | optional | ||||
| adv_sub5 | optional | ||||
| adv_unique1 | optional | ||||
| adv_unique2 | optional | ||||
| adv_unique3 | optional | ||||
| adv_unique4 | optional | ||||
| adv_unique5 | optional | ||||
| transaction_id | { transaction_id } | 102b983f153f632c9a0a1469e27b55 (example only) | transaction_id from a ShopBack redirect link | alphanumeric (30 digits) | mandatory |
| amount | { order_total } | See explanation below | mandatory | ||
| security_token | { security_token } | 070a632e2b574ca894d90610c7da97bc (example only) | Static security token specific to each merchant. Please obtain this value from your ShopBack representative. | alphanumeric (32 digits) | mandatory |
Example Order API
Merchant replaces the following fields with the actual values:
http://shopback.go2cloud.org/aff_lsr?
offer_id={order_offer_id}&
adv_sub={ customer_facing_order_id }&
transaction_id={ transaction_id }&
amount={ order_total }&
security_token={ security_token }
Order API Demonstration
Merchant replaces the following fields with the actual values:
- Order 123
- Order_total = RM100
- Click_id = ABCD1234
API 1:
http://shopback.go2cloud.org/aff_lsr?
offer_id={order_offer_id}&adv_sub=order_123&transaction_id=ABCD1234&amount=100&security_token={ security_token }
Order API Response
Status Code - 200
| String | Description |
|---|---|
| sucess=true; | The order has been created successfully by API call. |
| success=false; err_msg=Invalid Trans. ID | Transaction_id is in the wrong format. |
| success=false; err_msg=Request offer #1234 does not match session offer #2345. | This transaction_id wasn’t distributed by your offer. |
| success=false; err_msg=Duplicate recorded with Trans. ID | This transaction_id has already expired. |
Updated 12 months ago