Overview
Login
- Access
Merchants
- Merchant
- Configuration
- Explore
Catalog
- Offers
- SKUs
- Categories
- Collections
- Currencies
Orders & Checkout
- Carts
- Cart Items
- Cart Customer
- Cart Discounts
- Cart Shipping
- Cart Pricing
- Cart Payment
- Cart Completion
- Orders
- Order Refunds
- Order Cancellations
- Transfers
Events
- Webhooks
- Webhook Events
- Wekbhook Headers
Apps
- Merchant/App Installs
- Commission Rates
Operations
- Connection
Relay
- Shipping
Ecom Syncs
- Offers
Submit Cart
Properties for cart submission.
Associate the order with a user or affiliate in your system
Map the order in Violet to an order record within your system.
Transaction ID representing a transaction in the channels system.. This property only applies to channels approved for external payment processing.
Gateway used to submit the order. This property only applies to channels approved for external payment processing.
Details of the customer placing the order.
Customer's first name.
Customer's last name.
Customer's valid email address.
ID of the Customer on the External Platform
The shipping or billing address of a user placing an order
Name on Address
City
State or province abbreviated code.
Country ISO2 Code
Postal/Zip Code
Phone number related to the address. Note: Some external commerce platforms require this value. For these platforms Violet will use a fake number if no value is provided to ensure that the order succeeds.
Address Type
Email Address
First line of the Address
Second line of the Address
The shipping or billing address of a user placing an order
Name on Address
City
State or province abbreviated code.
Country ISO2 Code
Postal/Zip Code
Phone number related to the address. Note: Some external commerce platforms require this value. For these platforms Violet will use a fake number if no value is provided to ensure that the order succeeds.
Address Type
Email Address
First line of the Address
Second line of the Address
When only one address is provided, should the one address be used for both the shipping and billing addresses.
{
"id": 10000,
"token": "fz8x7gksdjsy2p9fdlonw7k9svwjso4b",
"user_id": 10000,
"app_id": 10000,
"developer_id": 10000,
"customer": {
"user_id": 10000,
"first_name": "Super",
"last_name": "Mario",
"email": "super@mar.io",
"name": "Super Mario"
},
"bags": [
{
"id": 11111,
"order_id": 10000,
"merchant_id": 10000,
"app_id": 10000,
"status": "ACCEPTED",
"fulfillment_status": "PROCESSING",
"financial_status": "PAID",
"skus": [
{
"id": 10000,
"merchant_id": 10000,
"app_id": 10000,
"sku_id": 99999,
"external_id": "1234567890",
"name": "Nintendo Entertainment System",
"brand": "Nintendo",
"thumbnail": "https://res.cloudinary.com/violet/image/upload/c_thumb,w_200,g_face/v1729220594/product_media/2taesr1g7sciu8agrrtgaafi2dnzzmsv.jpg",
"quantity": 2,
"price": 9999,
"weight": 1,
"available": true,
"status": "PROCESSING",
"product_type": "PHYSICAL",
"custom": false,
"line_price": 19998
}
],
"shipping_method": {
"carrier": "USPS",
"shipping_method_id": "07d19139fc0f4558687c1900c696f071",
"bag_id": 11111,
"merchant_id": 10000,
"label": "Priority Mail",
"price": 644,
"custom": false
},
"taxes": [
{
"order_id": 127021,
"merchant_id": 10009,
"state": "WA",
"rate": 6.5,
"amount": 1300,
"description": "Washington State Tax"
},
{
"order_id": 127021,
"merchant_id": 10009,
"state": "WA",
"rate": 0,
"amount": 0,
"description": "King County Tax"
},
{
"order_id": 127021,
"merchant_id": 10009,
"state": "WA",
"rate": 3.85,
"amount": 770,
"description": "Seattle City Tax"
}
],
"sub_total": 19998,
"shipping_total": 644,
"tax_total": 2070,
"discount_total": 0,
"total": 22712,
"taxes_included": false,
"external_checkout": true,
"commission_rate": 10,
"date_created": "2017-06-15T01:01:01+0000",
"date_last_modified": "2017-06-15T01:01:01+0000",
"remorse_period_ends": "2017-06-15T01:01:01+0000",
"currency": "USD",
"external_currency": "USD",
"channel": "APP",
"platform": "SHOPIFY",
"fulfillments": [],
"discounts": [],
"wallet_based_checkout": false,
"bag_id": 22222,
"bag_status": "IN_PROGRESS",
"merchant_name": "Legacy Games"
}
],
"shipping_address": {
"name": "Super Mario",
"city": "Seattle",
"state": "WA",
"country": "US",
"postal_code": "98121",
"phone": "1234567890",
"type": "SHIPPING",
"address_1": "2815 Elliott Ave, Unit 100",
"first_name": "Super",
"last_name": "Mario"
},
"billing_address": {
"name": "Super Mario",
"city": "Seattle",
"state": "WA",
"country": "US",
"postal_code": "98121",
"phone": "1234567890",
"type": "BILLING",
"address_1": "2815 Elliott Ave, Unit 100",
"first_name": "Super",
"last_name": "Mario"
},
"payment_method": {
"brand": "visa",
"last_four": "4242",
"exp_month": 12,
"exp_year": 2025,
"payment_method_id": 35236
},
"sub_total": 19998,
"shipping_total": 644,
"tax_total": 2070,
"discount_total": 0,
"total": 22712,
"app_order_id": "00100100",
"status": "COMPLETED",
"is_guest": true,
"date_created": "2017-06-15T01:01:01+0000",
"date_last_modified": "2017-06-15T01:01:01+0000",
"priced": true,
"wallet_based_checkout": false,
"currency": "USD",
"channel": "APP",
"currency_symbol": "$",
"stripe_key": "pk_test_UHg8oLvg4rrDCbvtqfwTE8qd",
"payment_intent_client_secret": "pi_vw8krrsvposl347c5l7x1nt5_secret_vbcw5t2bze37iptq430tmx7s",
"payment_transactions": [
{
"id": 99999,
"order_id": 10000,
"payment_provider": "STRIPE",
"payment_provider_transaction_id": "pi_vw8krrsvposl347c5l7x1nt5",
"payment_method_id": 77777,
"payment_provider_payment_method_id": "pm_1PtHCnK29KDiBVldrynYIy0k",
"payment_intent_client_secret": "pi_vw8krrsvposl347c5l7x1nt5_secret_vbcw5t2bze37iptq430tmx7s",
"amount": 22712,
"metadata": {
"payment_intent_client_secret": "pi_vw8krrsvposl347c5l7x1nt5_secret_vbcw5t2bze37iptq430tmx7s",
"payment_intent_id": "pi_vw8krrsvposl347c5l7x1nt5"
},
"related_bags": [
"11111"
],
"currency": "USD",
"capture_status": "CAPTURED",
"errors": [],
"date_created": "2024-08-29T22:52:42+0000",
"date_last_modified": "2024-08-29T22:52:52+0000",
"status": "CAPTURED"
}
],
"intent_based_checkout": true,
"guest": true,
"order_id": 10000
}Submit a Cart given its cart_id. This submits carts to any relevant E-Commerce platforms.
Handling Cart Submission Errors
While we strive to ensure that cart submission succeeds, there may occassionally be scenarios where cart submission fails in a way where it cannot be automatically reconciled. The following examples show what to expect when submission failure occurs for single-bag and multi-bag carts.
Single Bag Cart Submission Errors
When the submission of a Violet cart containing a single bag results in a failed sumission, the error will be surfaced as an API Exception in the response body. This error will typically be surface with a 400 or 422 HTTP status.
{
"message": "Could not complete external cart: One or more items in the cart are no longer available for purchase.",
"error": "external_cart_completion_error",
"code": 2503,
"data": {
"skus": [
{
"message": "This item is no longer available for purchase.",
"name": "Sample Product",
"sku_id": 99999,
"order_sku_id": 88888,
"bag_id": 77777
}
]
}
}
Multi-Bag Cart Submission Errors
When the submission of a Violet cart containing multible bags results in one or more failed sumissions, any error(s) will be nested in the "errors": [] array on the Order object.
entity_type is SKU, the entity_id property will map to the sku_id property on a Sku in the Cart.
{
...
"errors": [{
"id": 55555,
"order_id": 66666,
"bag_id": 77777,
"entity_id": "99999",
"entity_type": "SKU",
"type": "EXTERNAL_SUBMIT_CART",
"message": "This item is no longer available for purchase.",
"date_created": "2023-11-07T05:31:56Z",
"platform": "SHOPIFY"
}]
...
}
Path Parameters
Body
Properties for cart submission.
Associate the order with a user or affiliate in your system
Map the order in Violet to an order record within your system.
Transaction ID representing a transaction in the channels system.. This property only applies to channels approved for external payment processing.
Gateway used to submit the order. This property only applies to channels approved for external payment processing.
Details of the customer placing the order.
Customer's first name.
Customer's last name.
Customer's valid email address.
ID of the Customer on the External Platform
The shipping or billing address of a user placing an order
City
State or province abbreviated code.
Country ISO2 Code
Postal/Zip Code
Address Type
SHIPPING, BILLING First line of the Address
Name on Address
Phone number related to the address. Note: Some external commerce platforms require this value. For these platforms Violet will use a fake number if no value is provided to ensure that the order succeeds.
Email Address
Second line of the Address
The shipping or billing address of a user placing an order
City
State or province abbreviated code.
Country ISO2 Code
Postal/Zip Code
Address Type
SHIPPING, BILLING First line of the Address
Name on Address
Phone number related to the address. Note: Some external commerce platforms require this value. For these platforms Violet will use a fake number if no value is provided to ensure that the order succeeds.
Email Address
Second line of the Address
When only one address is provided, should the one address be used for both the shipping and billing addresses.
Response
Violet Order Entity
ID of the Violet cart or order.
An alternative UUID that can be used as an ID to reference the cart or order.
Errors on the Order. During checkout, if there was an error or issue on one of the order's bags, there will be an error added to this list describing the issue. The checkout API will return 200 with the order object in the response even if there was an issue with a bag so you must always check the response for errors in this list to know if there was an issue on the order.
Unique ID of the error.
ID of the parent Order this error occurred in.
ID of the parent Bag this error occurred in.
ID of the entity that caused the error. See the entity_type property to determine which entity this ID is associated with.
Type of entity that caused the error. See the entity_id property to determine which entity of this type is related to the error.
ORDER, BAG, SKU Type of error, indicates which action was being taken when the error occurred.
EXTERNAL_CREATE_CART, EXTERNAL_ADD_ITEM, EXTERNAL_UPDATE_ITEM, EXTERNAL_REMOVE_ITEM, EXTERNAL_ADD_CUSTOMER, EXTERNAL_ADD_ADDRESSES, EXTERNAL_ADD_SHIPPING_ADDRESS, EXTERNAL_ADD_BILLING_ADDRESS, EXTERNAL_GET_SHIPPING_METHODS, EXTERNAL_SET_SHIPPING_METHOD, EXTERNAL_SET_PAYMENT_METHOD, EXTERNAL_PRICE_CART, EXTERNAL_SUBMIT_CART, INTERNAL_ADD_ITEM, EXTERNAL_DELETE_CART, EXTERNAL_CANCEL_ORDER, EXTERNAL_WRITE_ORDER, EXTERNAL_MARK_ORDER_AS_PAID, EXTERNAL_ADD_DISCOUNT_CODE, EXTERNAL_REMOVE_DISCOUNT_CODE, EXTERNAL_DELETE_ORDER, EXTERNAL_REFUND_ORDER A string message providing more details about the error.
255Date the error was first created in Violet.
The external commerce platform the error occurred in.
OTHER, SHOPIFY, MAGENTO, MAGENTO_ONE, WOOCOMMERCE, BIGCOMMERCE, LIGHTSPEED, ECWID, YAAS, SPREECOMMERCE, DEMANDWARE, VOLUSION, PRESTASHOP, THREEDCART, SYLIUS, WIX, SWELL, MIVA, WEBSPHERE, ORACLECC, SAPCC, SQUARESPACE, SHOPWARE, COMMERCETOOLS, MEDUSA, ABICART, SPRYKER, MYSTORE, CENTRA, XCART, VTEX, KIBO, SALEOR, VENDO, CHORD, DIGITALRIVER, SQUARE, AMAZON, BIGCARTEL, CUSTOM ID of the User placing the order
ID of the App responsible for the creation and submission of this Order.
ID of the Developer responsible for the creation and submission of this Order.
Details of the customer placing the order.
Customer's first name.
Customer's last name.
Customer's valid email address.
Reference ID of the customer placing the order.
ID of the Customer on the External Platform
The shipping or billing address of a user placing an order
City
State or province abbreviated code.
Country ISO2 Code
Postal/Zip Code
Address Type
SHIPPING, BILLING First line of the Address
Name on Address
Phone number related to the address. Note: Some external commerce platforms require this value. For these platforms Violet will use a fake number if no value is provided to ensure that the order succeeds.
Email Address
Second line of the Address
The shipping or billing address of a user placing an order
City
State or province abbreviated code.
Country ISO2 Code
Postal/Zip Code
Address Type
SHIPPING, BILLING First line of the Address
Name on Address
Phone number related to the address. Note: Some external commerce platforms require this value. For these platforms Violet will use a fake number if no value is provided to ensure that the order succeeds.
Email Address
Second line of the Address
When only one address is provided, should the one address be used for both the shipping and billing addresses.
Full name of the customer.
One or more Bags that make up the Order. Each Bag will contain the Sku's, shipping methods, and totals unique to a merchant. Each merchant in an Order will have their own Bag.
Unique ID of the Bag.
ID of the parent order the Bag is a child of.
ID of the merchant the Bag is related to.
ID of the App responsible for the creation and submission of this Order.
ID of the Order on the external commerce platform. This value will be null until the Order submitted.
Overall status of the Bag.
IN_PROGRESS, SUBMITTED, ACCEPTED, COMPLETED, PARTIALLY_REFUNDED, REFUNDED, REJECTED, CANCELED, BACKORDERED Fulfillment status of the Bag.
PROCESSING, SHIPPED, PARTIALLY_SHIPPED, DELIVERED, COULD_NOT_DELIVER, RETURNED Financial status of the Bag.
UNPAID, AUTHORIZED, PENDING, PAID, PARTIALLY_PAID, REFUNDED, PARTIALLY_REFUNDED, VOIDED Dispute status of the Bag.
UNDISPUTED, IN_DISPUTE, DISPUTE_WON, DISPUTE_LOST Sku's (line items) that have been added to the Bag.
Unique ID of the Sku in relation to the order.
ID of the parent Offer that this Sku is a child of.
ID of the Merchant this Sku belongs to.
ID of the App responsible for the creation and submission of this Order.
ID of the parent product the offer is a child off.
ID of the referenced Sku from the Violet catalog.
ID of the SKU on the external commerce platform.
Name of the Sku, as provided by the merchant.
Name of the brand selling this Sku.
URL of the thumbnail image. Useful for order overview displays.
Quantity of the Sku being purchased. Quantities over 1000 will default to 1000.
x < 1000Price of the individual SKU, in cents.
Weight of Sku.
Height of Sku.
Width of Sku.
Length of Sku.
Is the product still available for purchase. If a Sku becomes unavailable it likely means that the product became out of stock after it was added to the cart. Unavailable Sku's cannot be purchased.
Current status of the Sku.
IN_PROGRESS, PROCESSING, SHIPPED, PARTIALLY_SHIPPED, DELIVERED, COULD_NOT_DELIVER, RETURNED, CANCELED, REFUNDED, ERROR, PARTIALLY_RETURNED, PARTIALLY_REFUNDED Product type that describes the Sku.
PHYSICAL, DIGITAL, VIRTUAL, BUNDLED Is the Sku custom. Is true when the price has been overridden.
Used to provide the merchant with custom values for the product. This functionality is currently limited to Shopify merchants.
The quantity of this item that has been fulfilled by the merchant.
Rates that apply specifically to this Sku such as taxes, fees, or duties.
ID of the Order SKU the Rate belongs to
Total Tax amount on Bag. In Cents
Rate
Rate Type
TAX, SHIPPING, FEE, DUTY Rate Name
Price of the Sku multiplied by the quantity, in Cents
Shipping Methods belonging to an Order
Total cost of the Shipping Method. In Cents
ID of the referenced Shipping Method
ID of the Bag the Shipping Method applies to
ID of the merchant the bag belongs to
Type of Shipping Method
CALCULATED, FLAT_RATE_PRICE, FLAT_RATE_WEIGHT OTHER, UPS, USPS, FEDEX, DHL, ONTRAC, ROYAL_MAIL, SENDLE, POSTNORD Shipping Method Label
Is the shipping method custom. True when the price has been overridden.
Minimum Subtotal. In Cents. Only applies to Flat Rate by Price
Maximum Subtotal. In Cents. Only applies to Flat Rate by Price
Minimum Weight. In Cents. Only applies to Flat Rate by Weight
Maximum Weight. In Cents. Only applies to Flat Rate by Weight
ID(s) on external ecommerce platform
Carrier Tracking Number
Tax rates applied to the Bag.
ID of the Order the Tax belongs to
ID of the Merchant the Bag belongs to
SKUs covered by the Tax
State abbreviation
Postal/Zip Code
Tax Rate
Total Tax amount on Bag. In Cents
Description of the Tax
255The price of the Bag in the base currency before discounts, shipping, duties, taxes, and tips. In Cents.
The sum of all shipping methods applied to the Bag in the base currency. In Cents
The sum of all the taxes applied to the Bag in the base currency. In Cents
The total discounts applied to the price of the Bag in the base currency. In Cents
The sum of all item prices, discounts, shipping, and taxes applied to the Bag in the base currency. In Cents
Are taxes included in the cart subtotal. When true the taxes will not be summed separately.
If the Bag is attached to an external cart in the commerce platform.
The rate used to calculate the apps commission rate for the Bag.
Date the Bag was created in Violet.
Date the Bag was last modified in Violet.
Date the Bag was last checked for updates. This is a part of Order Parity and is used to discover missed or unsent webhooks from the external commerce platforms.
Date when the Bag can no longer be refunded.
Base currency of the Bag.
Currency of the equivalent cart on external commerce platform.
Exchange rate of currency and external currency, if different, at the time the Bag was last priced.
The type of Channel that originated this Bag.
APP, MARKETPLACE, FACEBOOK, INSTAGRAM, WALMART, GOOGLE, TIKTOK, SNAPCHAT, PINTEREST Optional ID of the Order in the channels system. Automatically obtained through the app_order_id applied to the Order.
The commerce platform used by this merchant.
OTHER, SHOPIFY, MAGENTO, MAGENTO_ONE, WOOCOMMERCE, BIGCOMMERCE, LIGHTSPEED, ECWID, YAAS, SPREECOMMERCE, DEMANDWARE, VOLUSION, PRESTASHOP, THREEDCART, SYLIUS, WIX, SWELL, MIVA, WEBSPHERE, ORACLECC, SAPCC, SQUARESPACE, SHOPWARE, COMMERCETOOLS, MEDUSA, ABICART, SPRYKER, MYSTORE, CENTRA, XCART, VTEX, KIBO, SALEOR, VENDO, CHORD, DIGITALRIVER, SQUARE, AMAZON, BIGCARTEL, CUSTOM A list of fulfillments, if any, that have been applied to this Bag.
ID of the bag the fulfillment belongs to.
ID of the fulfillment on the external commerce platform.
Carrier responsible for the fulfillment. Will be OTHER if raw carrier is not recognized.
OTHER, UPS, USPS, FEDEX, DHL, ONTRAC, ROYAL_MAIL, SENDLE, POSTNORD Raw name of carrier from the external commerce platform.
Status of the bag fullfillment.
PENDING, PROCESSING, SUCCESS, CANCELED, ERROR, FAILURE, NONE_PROVIDED Status provided by the carrier.
PENDING, LABEL_PURCHASED, LABEL_PRINTED, CONFIRMED, READY_FOR_PICKUP, IN_TRANSIT, OUT_FOR_DELIVERY, ATTEMPTED_DELIVERY, DELIVERED, FAILURE, NONE_PROVIDED Tracking number provided by the carrier.
Tracking URL provided by the carrier.
SKUs fulfilled by this fulfillment.
ID of the fulfillment that contains this item.
ID of the SKU in the Bag.
Quantity of the this item fulfilled by this fulfillment.
A list of discounts, if any, that have been applied to this Bag.
ID of the Bag this discount belong to
Status of discount
PENDING, APPLIED, INVALID, NOT_SUPPORTED, ERROR, EXPIRED Type of discount
CODE Value type of discount
AMOUNT, PERCENTAGE Target type of the discount
ORDER, SKU, SHIPPING Code of discount
External ID of discount
Amount of discount
Percentage of discount
Total amount of discount applied to bag
Date of creation
Date of last bag discount update
Customer email address, possibly necessary for once-per-customer discounts.
Is this Bag going to be placed through wallet-based checkout.
Name of app that originated the order. Use the "extended" query param when looking up orders to include this value.
IN_PROGRESS, SUBMITTED, ACCEPTED, COMPLETED, PARTIALLY_REFUNDED, REFUNDED, REJECTED, CANCELED, BACKORDERED Name of the merchant the Bag is related to.
The shipping or billing address of a user placing an order
City
State or province abbreviated code.
Country ISO2 Code
Postal/Zip Code
Address Type
SHIPPING, BILLING First line of the Address
Name on Address
Phone number related to the address. Note: Some external commerce platforms require this value. For these platforms Violet will use a fake number if no value is provided to ensure that the order succeeds.
Email Address
Second line of the Address
The shipping or billing address of a user placing an order
City
State or province abbreviated code.
Country ISO2 Code
Postal/Zip Code
Address Type
SHIPPING, BILLING First line of the Address
Name on Address
Phone number related to the address. Note: Some external commerce platforms require this value. For these platforms Violet will use a fake number if no value is provided to ensure that the order succeeds.
Email Address
Second line of the Address
Payment Method belonging to an Order
ID of the referenced Payment Method
Brand of Card
Last Four Numbers on Card
Card Expiration Month
Card Expiration Year
Name as it appears on Card
Is Default Method
The price of the Order in the base currency before discounts, shipping, duties, taxes, and tips. In Cents.
The sum of all shipping methods applied to the Order in the base currency. In Cents.
The sum of all the taxes applied to the Order in the base currency. In Cents.
The total discounts applied to the price of the Order in the base currency. In Cents.
The sum of all item prices, discounts, shipping, and taxes applied to the Order in the base currency. In Cents.
App Customer ID. This should be used to map the order to the ID of the customer in your application.
App Order ID. This should be set to a unique identifier in your system. While not enforced unique in Violet's system, it is strongly recommended that unique values are used for each cart to help correlate identifiers between Violet's system and yours.
Status of the Order
IN_PROGRESS, PROCESSING, COMPLETED, CANCELED, PARTIALLY_REFUNDED, REFUNDED, REQUIRES_ACTION Order is Guest
Date of order creation
Date of last order update
Is the cart priced
Is this cart going to be placed through wallet-based checkout
Base currency of cart
Optional value used to represent an identifier in your system. This value is not required to represent a referral. It can represent the ID of anything in your system and can be used to filter order lookup results. Max length of 128 characters.
Symbol representing the currency the Order operates in.
Name of app that originated the order. Use the "extended" query param when looking up orders to include this value.
Stripe publishable key. Use for tokenizing payment methods.
Payment intent client secret. Use for payment intent based payment capture and external captures
Payment Transactions associated to the bags on this Cart
Unique identifier for the object
Identifier of the Order entity that this payment transaction is associated with
Payment Provider that this transaction is executed against. This is the provider that handles payment processing for this transaction.
Identifier of the payment transaction in the underlying payment provider system.
Identifier of the payment method associated with this payment transaction in Violet.
Identifier of the payment method associated with this payment transaction in the underlying payment provider system.
Client secret for the payment intent associated to this payment transaction
Amount of this payment in the fractional currency unit of this transaction (e.g. cents). This is the amount charged to the shopper.
Currency that the amount of this payment transaction is reflected in. This is the currency that the payment provider uses to charge the shopper payment method.
Underlying status of the payment capture in the payment provider system and should be used to determine what action to take next against this payment transaction.
PROCESSING, CAPTURED, CANCELLED, FAILED, BYPASSED, REQUIRES_ACTION, REQUIRES_PAYMENT_METHOD, REQUIRES_AUTHORIZATION, AUTHORIZED, REFUNDED, PARTIALLY_REFUNDED Underlying status of the payment in the payment provider system and should be used to determine what action to take next against this payment transaction.
AUTOMATIC, CUSTOM, EXTERNAL Status of the transfer of distributions associated with this payment transaction.
SENT, REVERSED, PARTIALLY_REVERSED, PENDING, FAILED, BYPASSED Underlying status of the payment in the payment provider system and should be used to determine what action to take next against this payment transaction.
AUTOMATIC, CUSTOM, EXTERNAL Metadata from the payment provider associated to this payment transaction
Metadata from the payment provider associated to this payment transaction
Identifiers of the Bags in Violet that are associated with this payment transaction. The amount of this payment transaction is directly computed from the total amounts on the related bags.
Identifiers of the Refunds in Violet that are associated with this payment transaction. Refund amounts are not reflected in the amount on this payment transaction.
List of errors associated to this payment transaction during processing.. This value will only be populated if there are errors during processing
Unique identifier for the object.
Unique error code corresponding to this error.
Error message describing the issue in the underlying system.
Identifier of the PaymentTransaction entity that this error is associated with
Time at which the object was created. In ISO-8601 format.
Time at which the object was last modified. In ISO-8601 format.
PROCESSING, CAPTURED, CANCELLED, FAILED, BYPASSED, REQUIRES_ACTION, REQUIRES_PAYMENT_METHOD, REQUIRES_AUTHORIZATION, AUTHORIZED, REFUNDED, PARTIALLY_REFUNDED IN_PROGRESS, PROCESSING, COMPLETED, CANCELED, PARTIALLY_REFUNDED, REFUNDED, REQUIRES_ACTION Boolean indicating if the cart/order will be payed using a payment intent.
Was this page helpful?
{
"id": 10000,
"token": "fz8x7gksdjsy2p9fdlonw7k9svwjso4b",
"user_id": 10000,
"app_id": 10000,
"developer_id": 10000,
"customer": {
"user_id": 10000,
"first_name": "Super",
"last_name": "Mario",
"email": "super@mar.io",
"name": "Super Mario"
},
"bags": [
{
"id": 11111,
"order_id": 10000,
"merchant_id": 10000,
"app_id": 10000,
"status": "ACCEPTED",
"fulfillment_status": "PROCESSING",
"financial_status": "PAID",
"skus": [
{
"id": 10000,
"merchant_id": 10000,
"app_id": 10000,
"sku_id": 99999,
"external_id": "1234567890",
"name": "Nintendo Entertainment System",
"brand": "Nintendo",
"thumbnail": "https://res.cloudinary.com/violet/image/upload/c_thumb,w_200,g_face/v1729220594/product_media/2taesr1g7sciu8agrrtgaafi2dnzzmsv.jpg",
"quantity": 2,
"price": 9999,
"weight": 1,
"available": true,
"status": "PROCESSING",
"product_type": "PHYSICAL",
"custom": false,
"line_price": 19998
}
],
"shipping_method": {
"carrier": "USPS",
"shipping_method_id": "07d19139fc0f4558687c1900c696f071",
"bag_id": 11111,
"merchant_id": 10000,
"label": "Priority Mail",
"price": 644,
"custom": false
},
"taxes": [
{
"order_id": 127021,
"merchant_id": 10009,
"state": "WA",
"rate": 6.5,
"amount": 1300,
"description": "Washington State Tax"
},
{
"order_id": 127021,
"merchant_id": 10009,
"state": "WA",
"rate": 0,
"amount": 0,
"description": "King County Tax"
},
{
"order_id": 127021,
"merchant_id": 10009,
"state": "WA",
"rate": 3.85,
"amount": 770,
"description": "Seattle City Tax"
}
],
"sub_total": 19998,
"shipping_total": 644,
"tax_total": 2070,
"discount_total": 0,
"total": 22712,
"taxes_included": false,
"external_checkout": true,
"commission_rate": 10,
"date_created": "2017-06-15T01:01:01+0000",
"date_last_modified": "2017-06-15T01:01:01+0000",
"remorse_period_ends": "2017-06-15T01:01:01+0000",
"currency": "USD",
"external_currency": "USD",
"channel": "APP",
"platform": "SHOPIFY",
"fulfillments": [],
"discounts": [],
"wallet_based_checkout": false,
"bag_id": 22222,
"bag_status": "IN_PROGRESS",
"merchant_name": "Legacy Games"
}
],
"shipping_address": {
"name": "Super Mario",
"city": "Seattle",
"state": "WA",
"country": "US",
"postal_code": "98121",
"phone": "1234567890",
"type": "SHIPPING",
"address_1": "2815 Elliott Ave, Unit 100",
"first_name": "Super",
"last_name": "Mario"
},
"billing_address": {
"name": "Super Mario",
"city": "Seattle",
"state": "WA",
"country": "US",
"postal_code": "98121",
"phone": "1234567890",
"type": "BILLING",
"address_1": "2815 Elliott Ave, Unit 100",
"first_name": "Super",
"last_name": "Mario"
},
"payment_method": {
"brand": "visa",
"last_four": "4242",
"exp_month": 12,
"exp_year": 2025,
"payment_method_id": 35236
},
"sub_total": 19998,
"shipping_total": 644,
"tax_total": 2070,
"discount_total": 0,
"total": 22712,
"app_order_id": "00100100",
"status": "COMPLETED",
"is_guest": true,
"date_created": "2017-06-15T01:01:01+0000",
"date_last_modified": "2017-06-15T01:01:01+0000",
"priced": true,
"wallet_based_checkout": false,
"currency": "USD",
"channel": "APP",
"currency_symbol": "$",
"stripe_key": "pk_test_UHg8oLvg4rrDCbvtqfwTE8qd",
"payment_intent_client_secret": "pi_vw8krrsvposl347c5l7x1nt5_secret_vbcw5t2bze37iptq430tmx7s",
"payment_transactions": [
{
"id": 99999,
"order_id": 10000,
"payment_provider": "STRIPE",
"payment_provider_transaction_id": "pi_vw8krrsvposl347c5l7x1nt5",
"payment_method_id": 77777,
"payment_provider_payment_method_id": "pm_1PtHCnK29KDiBVldrynYIy0k",
"payment_intent_client_secret": "pi_vw8krrsvposl347c5l7x1nt5_secret_vbcw5t2bze37iptq430tmx7s",
"amount": 22712,
"metadata": {
"payment_intent_client_secret": "pi_vw8krrsvposl347c5l7x1nt5_secret_vbcw5t2bze37iptq430tmx7s",
"payment_intent_id": "pi_vw8krrsvposl347c5l7x1nt5"
},
"related_bags": [
"11111"
],
"currency": "USD",
"capture_status": "CAPTURED",
"errors": [],
"date_created": "2024-08-29T22:52:42+0000",
"date_last_modified": "2024-08-29T22:52:52+0000",
"status": "CAPTURED"
}
],
"intent_based_checkout": true,
"guest": true,
"order_id": 10000
}