Create Order

Endpoint: https://rest.virtualincentives.com/{version}/{format}/order

Method: POST

Definitions

FieldTypeDescription
programidrequired
integer
The programid serves as an identifier that determines the funding account and branding to use for this request.
clientidrequired (empty)
string(50)
The clientid provides unique a identifier for the request. This field also serves as a duplicate transaction check. After a successful transaction is placed using this identifier, all subsequent requests using the same identifier are rejected as duplicate orders.
emailrequired
string(200)
The email is the account holder email address.

Note: For anonymous rewards, please use a generic support email address, such as [email protected].
firstnamerequired
string(50)
Account holder first name.
lastnamerequired
string(50)
Account holder last name.
skurequired
string(50)
Virtual prepaid product SKU requested.

Note: SKU document delivered separately.
amountrequired
decimal
Denomination of the reward being issued.

Note: Currency is determined by the SKU requested.
address1optional
string(100)
Account holder address line 1.
address2optional
string(50)
Account holder address line 2.
cityoptional
string(50)
Account holder city.
stateoptional
string(20)
Account holder state abbreviation (ISO 3166-2, subdivision).
zipoptional
string(10)
Account holder zip code.
countryoptional
string(2)
Account holder country abbreviation (ISO 3166-2).
udf1optional
string(4000)
User Defined Field (UDF) to associate with the account holder. This field can be order, user, or transaction specifier. Also, these fields can be passed through.
udf2optional
string(4000)
Additional User Defined field.

Note: See ‘udf1’ for definition.
udf3optional
string(4000)
Additional User Defined field.

Note: See ‘udf1’ for definition.
udf4optional
string(4000)
Additional User Defined field.

Note: See ‘udf1’ for definition.
udf5optional
string(4000)
Additional User Defined field.

Note: See ‘udf1’ for definition.
udf6optional
string(4000)
Additional User Defined field.

Note: See ‘udf1’ for definition.
udf7optional
string(4000)
Additional User Defined field.

Note: See ‘udf1’ for definition.
udf8optional
string(4000)
Additional User Defined field.

Note: See ‘udf1’ for definition.
udf9optional
string(4000)
Additional User Defined field.

Note: See ‘udf1’ for definition.
udf10optional
string(4000)
Additional User Defined field.

Note: See ‘udf1’ for definition.
phoneoptional
string(20)
Mobile phone number of the recipient. Used for SMS reward delivery. The number must be supplied as digits only.

Note: Required if reward delivery is SMS, or phone country is provided.
phonecountryoptional
string(2)
Mobile phone number country of origin. This is the 2-character country code (ISO 3166-2).

Note: Required if reward delivery is SMS, or phone number is provided.
w9eligibleoptional
string(5)
Determines the W9 Eligibility of a reward for 1099 reporting. Options are true or false.
w9idoptional
string(50)
The W9ID used for 1099 reporting.

Note: Required if w9eligible is true.
numberresponse only
integer
Order number generated upon successful creation.
statusresponse only
string(50)
Status of the requested order. See Appendix A for definitions.
linkresponse only
string(250)
Redemption link returned upon successful account creation.

Examples

Single Reward Request XML

<order> 
 <programid>26490</programid>
 <clientid>56258125</clientid>
 <accounts>
  <account>
  <firstname>John</firstname>
  <lastname>Doe</lastname>
  <email>[email protected]</email>
  <sku>UVC-V-A06</sku>
  <amount>10.00</amount>
  </account>
 </accounts>
</order>

Single Reward Response XML

<order>
 <programid>26490</programid>
 <clientid>56258125</clientid>
 <number>24681234</number>
 <status>completed</status>
 <accounts>
  <account>
   <id>88523</id>
   <firstname>John</firstname>
   <lastname>Doe</lastname>
   <email>[email protected]</email>
   <sku>UVC-V-A06</sku>
   <amount>10.00</amount>
   <link>
    https://www.virtualrewardcenter.com/
    Landing.aspx?id=88523&sid=093677BA-71FA-4137-B435-C17B1748E725
   </link>
  </account>
 </accounts>
</order>

Single Reward Request JSON

{
 "order": {
  "programid":"26490",
  "clientid":"56258125",
  "accounts":[
   {
   "firstname":"John",
   "lastname":"Doe",
   "email":"[email protected]",
   "sku":"UVC-V-A06",
   "amount":"10.00"
   }
  ]
 }
}

Single Reward Response JSON

{
 "order":{
  "programid":"26490",
  "clientid":"56258125",
  "number":"24681234",
  "status":"completed",
  "accounts":[
   {
    "id":"85425",
    "firstname":"John",
    "lastname":"Doe",
    "email":"[email protected]",
    "sku":"UVC-V-A06",
    "amount":"10.00",
    "link":"https://www.virtualrewardcenter.com/
     Landing.aspx?id=85425&sid=b173b47f-228c-4a97
     -8d68-e5835ca4ac66"
   }
  ]
 }
}

Mutiple Rewards Request XML

<order> 
 <programid>26490</programid>
 <clientid>56258125</clientid>
 <accounts>
  <account>
   <firstname>John</firstname>
   <lastname>Doe</lastname>
   <email>[email protected]</email>
   <address1>123 Any Street</address1>
   <address2>Apt 212</address2>
   <city>Any City</city>
   <state>NY</state>
   <zip>98625</zip>
   <country>US</country>
   <sku>UVC-V-A06</sku>
   <amount>10.00</amount>
  </account>
  <account>
   <firstname>Jane</firstname>
   <lastname>Doe</lastname>
   <email>[email protected]</email>
   <sku>UVC-V-A06</sku>
   <amount>25.00</amount>
  </account>
 </accounts>
</order>

Multiple Rewards Request JSON

{
 "order": {
  "programid":"26490",
  "clientid":"56258125",
  "accounts":[
   {
    "firstname":"John",
    "lastname":"Doe",
    "email":"[email protected]",
    "address1":"123 Any Street",
    "address2":"Apt 212",
    "city":"Any City",
    "state":"NY",
    "zip":"98625",
    "country":"US",
    "sku":"UVC-V-A06",
    "amount":"10.00",
    "udf1":"",
    "udf2":""
   },
   {
    "firstname":"Jane",
    "lastname":"Doe",
    "email":"[email protected]",
    "sku":"UVC-V-A06",
    "amount":"25.00",
    "udf1":"",
    "udf2":""
   }
  ]
 }
}

Multiple Rewards Response XML

<order>
 <programid>26490</programid>
 <clientid>56258125</clientid>
 <number>24681234</number>
 <status>completed</status>
 <accounts>
  <account>
   <id>88523</id>
   <firstname>John</firstname>
   <lastname>Doe</lastname>
   <email>[email protected]</email>
   <address1>123 Any Street</address1>
   <address2>Apt 212</address2>
   <city>Any City</city>
   <state>NY</state>
   <zip>98625</zip>
   <country>US</country>
   <sku>UVC-V-A06</sku>
   <amount>10.00</amount>
   <link>
    https://www.virtualrewardcenter.com/
    Landing.aspx?id=88523&sid=093677BA-71FA-4137-B435-C17B1748E725
   </link>
  </account>
  <account>
   <id>88523</id>
   <firstname>Jane</firstname>
   <lastname>Doe</lastname>
   <email>[email protected]</email>
   <sku>UVC-V-A06</sku>
   <amount>25.00</amount>
   <link>
    https://www.virtualrewardcenter.com/
    Landing.aspx?id=88523&sid=093677BA-71FA-4137-B435-C17B1748E725
   </link>
  </account>
 </accounts>
</order>

Multiple Rewards Response JSON

{
 "order":{
  "programid":"26490",
  "clientid":"56258125",
  "number":"24681234",
  "status":"completed",
  "accounts":[
   {
    "id":"85425",
    "firstname":"John",
    "lastname":"Doe",
    "email":"[email protected]",
    "sku":"UVC-V-A06",
    "amount":"10.00",
    "link":"https://www.virtualrewardcenter.com/
     Landing.aspx?id=85425&sid=b173b47f-228c-4a97
     -8d68-e5835ca4ac66"
   }
   {
    "id":"85425",
    "firstname":"Jane",
    "lastname":"Doe",
    "email":"[email protected]",
    "sku":"UVC-V-A06",
    "amount":"10.00",
    "link":"https://www.virtualrewardcenter.com/
     Landing.aspx?id=85425&sid=b173b47f-228c-4a97
     -8d68-e5835ca4ac66"
   }
  ]
 }
}