Affiliate Orders / Create



Name

Affiliate Orders Create

Description

Create an Affiliate Order

Type

POST

URL

/v10/orders

Credential Type

Affiliate

 

Please review our information on placing Test Orders in our Sandbox environment.

Parameters

Name

Description

Type

Presence

Other

Name

Description

Type

Presence

Other

order

The order to create

Object

Required

 

Order Object Parameters

Name

Description

Type

Presence

Other

Name

Description

Type

Presence

Other

client_id

ID of the Client that is buying the tickets

Integer

Required

 

delivery

A Delivery object with details of the delivery information

Object

Required

 

discount

Additional amount subtracted from the order to be labeled as Discount. (Positive value, but will have a negative effect on the order total.)

Decimal

Optional

Maximum 2 decimal places

payments

Array of Payments which will be applied to the order. An array must be used even if creating a single payment.

Note: Payments of type credit_card will fail, even in Sandbox, if you have not yet signed up for the Braintree gateway

Array

Required

 

promo_code

The name of a promo code applied to an order. Does not automatically apply the discount, this is simply for your own logging purposes.

String

Optional

 

reference

Recommended for storing something such as a PO or Invoice number from another system.

String

Optional

 

service_fee

Additional amount added to the order to be labeled as a Service Fee

Decimal

Optional

Maximum 2 decimal places

session_id

Session ID of the buyer. This should be a unique session of the buyer.

String

Required if using Fraud Protection.

 

shipping

Additional amount added to the order to be labeled as Shipping Cost. Shipments / Suggestion will return the pricing you have configured for a shipment method.

Decimal

Optional

Maximum 2 decimal places

tax

Additional amount added to the order to be labeled as Tax. If you are using Tax Quotes / Create to calculate the retail tax amount you can pass the retail tax amount here for record keeping.

Decimal

Optional

Maximum 2 decimal places

tax_signature

Unique identifier generated by Tax Quotes / Create to ensure consistency between your quote and your order.

UUID

Optional



Internal Use Only Order Parameters

delivery Object Parameters

Name

Description

Type

Presence

Other

Name

Description

Type

Presence

Other

address_id

ID of the Client’s Address.

 

 

 

cost

Amount added to the order to be labeled as Shipping Cost. Shipments / Suggestion will return the pricing you have configured for a shipment method.

Decimal

Required

Maximum 2 decimal places

email_address_id

ID of the Client’s Email Address.

Integer

Required

 

phone_number_id

ID of the Client’s Phone Number.

 

 

 

type

The shipment type to use

 

 

 

payments Object Parameters

Name

Description

Value Type

Required

Other

Name

Description

Value Type

Required

Other

address_id

ID of a Client Address which is the billing address for the credit card being used.

Integer

Required

 

amount

The amount of the payment. Will be created for order total if omitted.

Decimal

Optional

Maximum 2 decimal places

token

The Stripe token representing the card.

String

Required

 

type

This will always be credit_card

String

Required

 

Recommended Shipment type options

The following shipment type options should be used.

Examples

In the examples below address_id, email_address_id, and phone_number_id may be replaced with their full corresponding objects as shown here.

"address_attributes": { "street_address": "9060 E Via Linda", "extended_address": "Suite 230", "locality": "Scottsdale", "region": "AZ", "postal_code": "85258", "country_code": "US", "label": "Work", "is_primary": true }
"email_address_attributes": { "address": "nedflanders@example.com", "label": "Home", "is_primary": true }
"phone_number_attributes": { "extension": "5", "number": "972-468-9750", "label": "iPhone", "is_primary": true }

Request

Response

Request

Response

POST /v10/orders

See Orders / Index