Downpay API Documentation
Downpay API Documentation
Terms of Service
API Endpoints
https://downpay.hypehound.app/graphql
Headers
# Your API token from the dashboard. Must be included in all API calls.
Authorization: Token bdbe58cf10e952359dcd730956d20c94a4acf00ff6f00088117b10b9f51660db
Version
2024-01
Queries
purchaseOptionGroup
Description
A single purchase option group
Response
Returns a PurchaseOptionGroup
Arguments
Name | Description |
---|---|
id - ID!
|
Example
Query
query purchaseOptionGroup($id: ID!) {
purchaseOptionGroup(id: $id) {
createdAt
id
lineItemDescriptor
merchantCode
orders {
edges {
...OrderEdgeFragment
}
nodes {
...OrderFragment
}
pageInfo {
...PageInfoFragment
}
}
productCount
productVariantCount
products {
id
imageUrl
title
}
productsRequirePurchaseOption
purchaseOptions {
billingPolicy {
...PurchaseOptionBillingPolicyFragment
}
description
id
}
resourceAssignmentType
tags
variants {
id
}
}
}
Variables
{"id": "4"}
Response
{
"data": {
"purchaseOptionGroup": {
"createdAt": ISO8601DateTime,
"id": "4",
"lineItemDescriptor": "xyz789",
"merchantCode": "xyz789",
"orders": OrderConnection,
"productCount": 987,
"productVariantCount": 123,
"products": [Product],
"productsRequirePurchaseOption": false,
"purchaseOptions": [PurchaseOption],
"resourceAssignmentType": "PRODUCTS",
"tags": ["abc123"],
"variants": [Variant]
}
}
}
purchaseOptionGroups
Description
A list of purchase option groups
Response
Returns a PurchaseOptionGroupConnection!
Arguments
Name | Description |
---|---|
after - String
|
Returns the elements in the list that come after the specified cursor. |
before - String
|
Returns the elements in the list that come before the specified cursor. |
first - Int
|
Returns the first n elements from the list. |
last - Int
|
Returns the last n elements from the list. |
Example
Query
query purchaseOptionGroups(
$after: String,
$before: String,
$first: Int,
$last: Int
) {
purchaseOptionGroups(
after: $after,
before: $before,
first: $first,
last: $last
) {
edges {
cursor
node {
...PurchaseOptionGroupFragment
}
}
nodes {
createdAt
id
lineItemDescriptor
merchantCode
orders {
...OrderConnectionFragment
}
productCount
productVariantCount
products {
...ProductFragment
}
productsRequirePurchaseOption
purchaseOptions {
...PurchaseOptionFragment
}
resourceAssignmentType
tags
variants {
...VariantFragment
}
}
pageInfo {
endCursor
hasNextPage
hasPreviousPage
startCursor
}
}
}
Variables
{
"after": "xyz789",
"before": "xyz789",
"first": 987,
"last": 987
}
Response
{
"data": {
"purchaseOptionGroups": {
"edges": [PurchaseOptionGroupEdge],
"nodes": [PurchaseOptionGroup],
"pageInfo": PageInfo
}
}
}
Mutations
createPurchaseOptionGroup
Description
Create a purchase option group
Response
Returns a CreatePurchaseOptionGroupPayload
Arguments
Name | Description |
---|---|
input - CreatePurchaseOptionGroupInput!
|
Parameters for CreatePurchaseOptionGroup |
Example
Query
mutation createPurchaseOptionGroup($input: CreatePurchaseOptionGroupInput!) {
createPurchaseOptionGroup(input: $input) {
clientMutationId
errors {
field
message
}
purchaseOptionGroup {
createdAt
id
lineItemDescriptor
merchantCode
orders {
...OrderConnectionFragment
}
productCount
productVariantCount
products {
...ProductFragment
}
productsRequirePurchaseOption
purchaseOptions {
...PurchaseOptionFragment
}
resourceAssignmentType
tags
variants {
...VariantFragment
}
}
}
}
Variables
{"input": CreatePurchaseOptionGroupInput}
Response
{
"data": {
"createPurchaseOptionGroup": {
"clientMutationId": "abc123",
"errors": [DisplayableError],
"purchaseOptionGroup": PurchaseOptionGroup
}
}
}
deletePurchaseOptionGroup
Description
Delete a purchase option group
Response
Returns a DeletePurchaseOptionGroupPayload
Arguments
Name | Description |
---|---|
input - DeletePurchaseOptionGroupInput!
|
Parameters for DeletePurchaseOptionGroup |
Example
Query
mutation deletePurchaseOptionGroup($input: DeletePurchaseOptionGroupInput!) {
deletePurchaseOptionGroup(input: $input) {
clientMutationId
deletedPurchaseOptionGroupId
errors {
field
message
}
}
}
Variables
{"input": DeletePurchaseOptionGroupInput}
Response
{
"data": {
"deletePurchaseOptionGroup": {
"clientMutationId": "abc123",
"deletedPurchaseOptionGroupId": "4",
"errors": [DisplayableError]
}
}
}
orderAuthorizePayment
Description
Authorize payment for an order
Response
Returns an OrderAuthorizePaymentPayload
Arguments
Name | Description |
---|---|
input - OrderAuthorizePaymentInput!
|
Parameters for OrderAuthorizePayment |
Example
Query
mutation orderAuthorizePayment($input: OrderAuthorizePaymentInput!) {
orderAuthorizePayment(input: $input) {
clientMutationId
errors {
field
message
}
orderPaymentStatus {
createdAt
orderId
paymentReferenceId
updatedAt
}
}
}
Variables
{"input": OrderAuthorizePaymentInput}
Response
{
"data": {
"orderAuthorizePayment": {
"clientMutationId": "xyz789",
"errors": [DisplayableError],
"orderPaymentStatus": OrderPaymentStatus
}
}
}
orderCollectPartialPayment
Description
Collect a partial payment for an order
Response
Returns an OrderCollectPartialPaymentPayload
Arguments
Name | Description |
---|---|
input - OrderCollectPartialPaymentInput!
|
Parameters for OrderCollectPartialPayment |
Example
Query
mutation orderCollectPartialPayment($input: OrderCollectPartialPaymentInput!) {
orderCollectPartialPayment(input: $input) {
clientMutationId
errors {
field
message
}
orderPaymentStatus {
createdAt
orderId
paymentReferenceId
updatedAt
}
}
}
Variables
{"input": OrderCollectPartialPaymentInput}
Response
{
"data": {
"orderCollectPartialPayment": {
"clientMutationId": "xyz789",
"errors": [DisplayableError],
"orderPaymentStatus": OrderPaymentStatus
}
}
}
orderCollectPayment
Description
Collect payment for an order
Response
Returns an OrderCollectPaymentPayload
Arguments
Name | Description |
---|---|
input - OrderCollectPaymentInput!
|
Parameters for OrderCollectPayment |
Example
Query
mutation orderCollectPayment($input: OrderCollectPaymentInput!) {
orderCollectPayment(input: $input) {
clientMutationId
errors {
field
message
}
orderPaymentStatus {
createdAt
orderId
paymentReferenceId
updatedAt
}
}
}
Variables
{"input": OrderCollectPaymentInput}
Response
{
"data": {
"orderCollectPayment": {
"clientMutationId": "abc123",
"errors": [DisplayableError],
"orderPaymentStatus": OrderPaymentStatus
}
}
}
orderRemovePaymentMethod
Description
Remove the stored payment method from an order
Response
Returns an OrderRemovePaymentMethodPayload
Arguments
Name | Description |
---|---|
input - OrderRemovePaymentMethodInput!
|
Parameters for OrderRemovePaymentMethod |
Example
Query
mutation orderRemovePaymentMethod($input: OrderRemovePaymentMethodInput!) {
orderRemovePaymentMethod(input: $input) {
clientMutationId
errors {
field
message
}
orderId
}
}
Variables
{"input": OrderRemovePaymentMethodInput}
Response
{
"data": {
"orderRemovePaymentMethod": {
"clientMutationId": "xyz789",
"errors": [DisplayableError],
"orderId": "4"
}
}
}
orderUpdateDueDate
Description
Update the payment due date for an order
Response
Returns an OrderUpdateDueDatePayload
Arguments
Name | Description |
---|---|
input - OrderUpdateDueDateInput!
|
Parameters for OrderUpdateDueDate |
Example
Query
mutation orderUpdateDueDate($input: OrderUpdateDueDateInput!) {
orderUpdateDueDate(input: $input) {
clientMutationId
errors {
field
message
}
orderId
paymentDueDate
}
}
Variables
{"input": OrderUpdateDueDateInput}
Response
{
"data": {
"orderUpdateDueDate": {
"clientMutationId": "abc123",
"errors": [DisplayableError],
"orderId": 4,
"paymentDueDate": ISO8601DateTime
}
}
}
orderVoidAuthorization
Description
Void an active authorization from an order
Response
Returns an OrderVoidAuthorizationPayload
Arguments
Name | Description |
---|---|
input - OrderVoidAuthorizationInput!
|
Parameters for OrderVoidAuthorization |
Example
Query
mutation orderVoidAuthorization($input: OrderVoidAuthorizationInput!) {
orderVoidAuthorization(input: $input) {
clientMutationId
errors {
field
message
}
orderId
}
}
Variables
{"input": OrderVoidAuthorizationInput}
Response
{
"data": {
"orderVoidAuthorization": {
"clientMutationId": "xyz789",
"errors": [DisplayableError],
"orderId": 4
}
}
}
purchaseOptionGroupAddProductVariants
Description
Add product variants to a purchase option group
Response
Arguments
Name | Description |
---|---|
input - PurchaseOptionGroupAddProductVariantsInput!
|
Parameters for PurchaseOptionGroupAddProductVariants |
Example
Query
mutation purchaseOptionGroupAddProductVariants($input: PurchaseOptionGroupAddProductVariantsInput!) {
purchaseOptionGroupAddProductVariants(input: $input) {
clientMutationId
errors {
field
message
}
purchaseOptionGroup {
createdAt
id
lineItemDescriptor
merchantCode
orders {
...OrderConnectionFragment
}
productCount
productVariantCount
products {
...ProductFragment
}
productsRequirePurchaseOption
purchaseOptions {
...PurchaseOptionFragment
}
resourceAssignmentType
tags
variants {
...VariantFragment
}
}
}
}
Variables
{"input": PurchaseOptionGroupAddProductVariantsInput}
Response
{
"data": {
"purchaseOptionGroupAddProductVariants": {
"clientMutationId": "abc123",
"errors": [DisplayableError],
"purchaseOptionGroup": PurchaseOptionGroup
}
}
}
purchaseOptionGroupAddProducts
Description
Add products to a purchase option group
Response
Returns a PurchaseOptionGroupAddProductsPayload
Arguments
Name | Description |
---|---|
input - PurchaseOptionGroupAddProductsInput!
|
Parameters for PurchaseOptionGroupAddProducts |
Example
Query
mutation purchaseOptionGroupAddProducts($input: PurchaseOptionGroupAddProductsInput!) {
purchaseOptionGroupAddProducts(input: $input) {
clientMutationId
errors {
field
message
}
purchaseOptionGroupId
}
}
Variables
{"input": PurchaseOptionGroupAddProductsInput}
Response
{
"data": {
"purchaseOptionGroupAddProducts": {
"clientMutationId": "xyz789",
"errors": [DisplayableError],
"purchaseOptionGroupId": 4
}
}
}
purchaseOptionGroupAddTags
Description
Add tags to a purchase option group
Response
Returns a PurchaseOptionGroupAddTagsPayload
Arguments
Name | Description |
---|---|
input - PurchaseOptionGroupAddTagsInput!
|
Parameters for PurchaseOptionGroupAddTags |
Example
Query
mutation purchaseOptionGroupAddTags($input: PurchaseOptionGroupAddTagsInput!) {
purchaseOptionGroupAddTags(input: $input) {
clientMutationId
errors {
field
message
}
purchaseOptionGroupId
}
}
Variables
{"input": PurchaseOptionGroupAddTagsInput}
Response
{
"data": {
"purchaseOptionGroupAddTags": {
"clientMutationId": "abc123",
"errors": [DisplayableError],
"purchaseOptionGroupId": 4
}
}
}
purchaseOptionGroupRemoveProductVariants
Description
Remove product variants from a purchase option group
Response
Arguments
Name | Description |
---|---|
input - PurchaseOptionGroupRemoveProductVariantsInput!
|
Parameters for PurchaseOptionGroupRemoveProductVariants |
Example
Query
mutation purchaseOptionGroupRemoveProductVariants($input: PurchaseOptionGroupRemoveProductVariantsInput!) {
purchaseOptionGroupRemoveProductVariants(input: $input) {
clientMutationId
errors {
field
message
}
removedProductVariantIds
}
}
Variables
{"input": PurchaseOptionGroupRemoveProductVariantsInput}
Response
{
"data": {
"purchaseOptionGroupRemoveProductVariants": {
"clientMutationId": "xyz789",
"errors": [DisplayableError],
"removedProductVariantIds": [4]
}
}
}
purchaseOptionGroupRemoveProducts
Description
Remove products from a purchase option group
Response
Returns a PurchaseOptionGroupRemoveProductsPayload
Arguments
Name | Description |
---|---|
input - PurchaseOptionGroupRemoveProductsInput!
|
Parameters for PurchaseOptionGroupRemoveProducts |
Example
Query
mutation purchaseOptionGroupRemoveProducts($input: PurchaseOptionGroupRemoveProductsInput!) {
purchaseOptionGroupRemoveProducts(input: $input) {
clientMutationId
errors {
field
message
}
purchaseOptionGroupId
removedProductIds
}
}
Variables
{"input": PurchaseOptionGroupRemoveProductsInput}
Response
{
"data": {
"purchaseOptionGroupRemoveProducts": {
"clientMutationId": "abc123",
"errors": [DisplayableError],
"purchaseOptionGroupId": 4,
"removedProductIds": [4]
}
}
}
purchaseOptionGroupRemoveTags
Description
Remove tags from a purchase option group
Response
Returns a PurchaseOptionGroupRemoveTagsPayload
Arguments
Name | Description |
---|---|
input - PurchaseOptionGroupRemoveTagsInput!
|
Parameters for PurchaseOptionGroupRemoveTags |
Example
Query
mutation purchaseOptionGroupRemoveTags($input: PurchaseOptionGroupRemoveTagsInput!) {
purchaseOptionGroupRemoveTags(input: $input) {
clientMutationId
errors {
field
message
}
purchaseOptionGroupId
removedProductTags
}
}
Variables
{"input": PurchaseOptionGroupRemoveTagsInput}
Response
{
"data": {
"purchaseOptionGroupRemoveTags": {
"clientMutationId": "xyz789",
"errors": [DisplayableError],
"purchaseOptionGroupId": 4,
"removedProductTags": ["abc123"]
}
}
}
updatePurchaseOptionGroup
Description
Update a purchase option group
Response
Returns an UpdatePurchaseOptionGroupPayload
Arguments
Name | Description |
---|---|
input - UpdatePurchaseOptionGroupInput!
|
Parameters for UpdatePurchaseOptionGroup |
Example
Query
mutation updatePurchaseOptionGroup($input: UpdatePurchaseOptionGroupInput!) {
updatePurchaseOptionGroup(input: $input) {
clientMutationId
errors {
field
message
}
purchaseOptionGroup {
createdAt
id
lineItemDescriptor
merchantCode
orders {
...OrderConnectionFragment
}
productCount
productVariantCount
products {
...ProductFragment
}
productsRequirePurchaseOption
purchaseOptions {
...PurchaseOptionFragment
}
resourceAssignmentType
tags
variants {
...VariantFragment
}
}
}
}
Variables
{"input": UpdatePurchaseOptionGroupInput}
Response
{
"data": {
"updatePurchaseOptionGroup": {
"clientMutationId": "xyz789",
"errors": [DisplayableError],
"purchaseOptionGroup": PurchaseOptionGroup
}
}
}
Types
Boolean
Description
Represents true
or false
values.
CreatePurchaseOptionGroupInput
Description
Autogenerated input type of CreatePurchaseOptionGroup
Fields
Input Field | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
purchaseOptionGroupInput - PurchaseOptionGroupInput!
|
Purchase option group input |
resourceAssignmentType - ResourceAssignment!
|
Determines how resources will be assigned to the purchase option group |
resources - ResourceInput!
|
Resources (products, variants, or tags) to associate with the purchase option group |
Example
{
"clientMutationId": "xyz789",
"purchaseOptionGroupInput": PurchaseOptionGroupInput,
"resourceAssignmentType": "PRODUCTS",
"resources": ResourceInput
}
CreatePurchaseOptionGroupPayload
Description
Autogenerated return type of CreatePurchaseOptionGroup.
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
errors - [DisplayableError!]
|
|
purchaseOptionGroup - PurchaseOptionGroup
|
Purchase option group describing the terms of the sale for a product or group of products |
Example
{
"clientMutationId": "abc123",
"errors": [DisplayableError],
"purchaseOptionGroup": PurchaseOptionGroup
}
CurrencyCode
Description
Currency code enum
Values
Enum Value | Description |
---|---|
|
United States Dollars (USD). |
|
Euro (EUR). |
|
United Kingdom Pounds (GBP). |
|
Canadian Dollars (CAD). |
|
Afghan Afghani (AFN). |
|
Albanian Lek (ALL). |
|
Algerian Dinar (DZD). |
|
Angolan Kwanza (AOA). |
|
Argentine Pesos (ARS). |
|
Armenian Dram (AMD). |
|
Aruban Florin (AWG). |
|
Australian Dollars (AUD). |
|
Barbadian Dollar (BBD). |
|
Azerbaijani Manat (AZN). |
|
Bangladesh Taka (BDT). |
|
Bahamian Dollar (BSD). |
|
Bahraini Dinar (BHD). |
|
Burundian Franc (BIF). |
|
Belize Dollar (BZD). |
|
Bermudian Dollar (BMD). |
|
Bhutanese Ngultrum (BTN). |
|
Bosnia and Herzegovina Convertible Mark (BAM). |
|
Brazilian Real (BRL). |
|
Bolivian Boliviano (BOB). |
|
Botswana Pula (BWP). |
|
Brunei Dollar (BND). |
|
Bulgarian Lev (BGN). |
|
Burmese Kyat (MMK). |
|
Cambodian Riel. |
|
Cape Verdean escudo (CVE). |
|
Cayman Dollars (KYD). |
|
Central African CFA Franc (XAF). |
|
Chilean Peso (CLP). |
|
Chinese Yuan Renminbi (CNY). |
|
Colombian Peso (COP). |
|
Comorian Franc (KMF). |
|
Congolese franc (CDF). |
|
Costa Rican Colones (CRC). |
|
Croatian Kuna (HRK). |
|
Czech Koruny (CZK). |
|
Danish Kroner (DKK). |
|
Dominican Peso (DOP). |
|
East Caribbean Dollar (XCD). |
|
Egyptian Pound (EGP). |
|
Ethiopian Birr (ETB). |
|
CFP Franc (XPF). |
|
Fijian Dollars (FJD). |
|
Gambian Dalasi (GMD). |
|
Ghanaian Cedi (GHS). |
|
Guatemalan Quetzal (GTQ). |
|
Guyanese Dollar (GYD). |
|
Georgian Lari (GEL). |
|
Haitian Gourde (HTG). |
|
Honduran Lempira (HNL). |
|
Hong Kong Dollars (HKD). |
|
Hungarian Forint (HUF). |
|
Icelandic Kronur (ISK). |
|
Indian Rupees (INR). |
|
Indonesian Rupiah (IDR). |
|
Israeli New Shekel (NIS). |
|
Iraqi Dinar (IQD). |
|
Jamaican Dollars (JMD). |
|
Japanese Yen (JPY). |
|
Jersey Pound. |
|
Jordanian Dinar (JOD). |
|
Kazakhstani Tenge (KZT). |
|
Kenyan Shilling (KES). |
|
Kuwaiti Dinar (KWD). |
|
Kyrgyzstani Som (KGS). |
|
Laotian Kip (LAK). |
|
Latvian Lati (LVL). |
|
Lebanese Pounds (LBP). |
|
Lesotho Loti (LSL). |
|
Liberian Dollar (LRD). |
|
Lithuanian Litai (LTL). |
|
Malagasy Ariary (MGA). |
|
Macedonia Denar (MKD). |
|
Macanese Pataca (MOP). |
|
Malawian Kwacha (MWK). |
|
Maldivian Rufiyaa (MVR). |
|
Mexican Pesos (MXN). |
|
Malaysian Ringgits (MYR). |
|
Mauritian Rupee (MUR). |
|
Moldovan Leu (MDL). |
|
Moroccan Dirham. |
|
Mongolian Tugrik. |
|
Mozambican Metical. |
|
Namibian Dollar. |
|
Nepalese Rupee (NPR). |
|
Netherlands Antillean Guilder. |
|
New Zealand Dollars (NZD). |
|
Nicaraguan Córdoba (NIO). |
|
Nigerian Naira (NGN). |
|
Norwegian Kroner (NOK). |
|
Omani Rial (OMR). |
|
Panamian Balboa (PAB). |
|
Pakistani Rupee (PKR). |
|
Papua New Guinean Kina (PGK). |
|
Paraguayan Guarani (PYG). |
|
Peruvian Nuevo Sol (PEN). |
|
Philippine Peso (PHP). |
|
Polish Zlotych (PLN). |
|
Qatari Rial (QAR). |
|
Romanian Lei (RON). |
|
Russian Rubles (RUB). |
|
Rwandan Franc (RWF). |
|
Samoan Tala (WST). |
|
Saudi Riyal (SAR). |
|
Serbian dinar (RSD). |
|
Seychellois Rupee (SCR). |
|
Singapore Dollars (SGD). |
|
Sudanese Pound (SDG). |
|
Syrian Pound (SYP). |
|
South African Rand (ZAR). |
|
South Korean Won (KRW). |
|
South Sudanese Pound (SSP). |
|
Solomon Islands Dollar (SBD). |
|
Sri Lankan Rupees (LKR). |
|
Surinamese Dollar (SRD). |
|
Swazi Lilangeni (SZL). |
|
Swedish Kronor (SEK). |
|
Swiss Francs (CHF). |
|
Taiwan Dollars (TWD). |
|
Thai baht (THB). |
|
Tanzanian Shilling (TZS). |
|
Trinidad and Tobago Dollars (TTD). |
|
Tunisian Dinar (TND). |
|
Turkish Lira (TRY). |
|
Turkmenistani Manat (TMT). |
|
Ugandan Shilling (UGX). |
|
Ukrainian Hryvnia (UAH). |
|
United Arab Emirates Dirham (AED). |
|
Uruguayan Pesos (UYU). |
|
Uzbekistan som (UZS). |
|
Vanuatu Vatu (VUV). |
|
Vietnamese đồng (VND). |
|
West African CFA franc (XOF). |
|
Yemeni Rial (YER). |
|
Zambian Kwacha (ZMW). |
|
Belarusian Ruble (BYN). |
|
Belarusian Ruble (BYR). BYR is deprecated. Use BYN available from version 2021-01 onwards instead.
|
|
Djiboutian Franc (DJF). |
|
Eritrean Nakfa (ERN). |
|
Falkland Islands Pounds (FKP). |
|
Gibraltar Pounds (GIP). |
|
Guinean Franc (GNF). |
|
Iranian Rial (IRR). |
|
Kiribati Dollar (KID). |
|
Libyan Dinar (LYD). |
|
Mauritanian Ouguiya (MRU). |
|
Sierra Leonean Leone (SLL). |
|
Saint Helena Pounds (SHP). |
|
Somali Shilling (SOS). |
|
Sao Tome And Principe Dobra (STD). STD is deprecated. Use STN available from version 2022-07 onwards instead.
|
|
Sao Tome And Principe Dobra (STN). |
|
Tajikistani Somoni (TJS). |
|
Tongan Pa'anga (TOP). |
|
Venezuelan Bolivares (VED). |
|
Venezuelan Bolivares (VEF). VEF is deprecated. Use VES available from version 2020-10 onwards instead.
|
|
Venezuelan Bolivares (VES). |
|
Unrecognized currency. |
Example
"USD"
DeletePurchaseOptionGroupInput
DeletePurchaseOptionGroupPayload
Description
Autogenerated return type of DeletePurchaseOptionGroup.
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
deletedPurchaseOptionGroupId - ID
|
ID of the deleted purchase option group |
errors - [DisplayableError!]
|
Example
{
"clientMutationId": "abc123",
"deletedPurchaseOptionGroupId": 4,
"errors": [DisplayableError]
}
DisplayableError
Float
Description
Represents signed double-precision fractional values as specified by IEEE 754.
Example
123.45
ID
Description
Represents a unique identifier that is Base64 obfuscated. It is often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "VXNlci0xMA=="
) or integer (such as 4
) input value will be accepted as an ID.
Example
4
ISO8601DateTime
Description
An ISO 8601-encoded datetime
Example
ISO8601DateTime
Int
Description
Represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
Example
123
MoneyInput
Fields
Input Field | Description |
---|---|
amount - String!
|
|
currencyCode - CurrencyCode!
|
Example
{"amount": "xyz789", "currencyCode": "USD"}
Order
Fields
Field Name | Description |
---|---|
createdAt - ISO8601DateTime!
|
|
id - ID!
|
The ID of the order. Same as the Shopify Order ID. |
updatedAt - ISO8601DateTime!
|
Example
{
"createdAt": ISO8601DateTime,
"id": 4,
"updatedAt": ISO8601DateTime
}
OrderAuthorizePaymentInput
Description
Autogenerated input type of OrderAuthorizePayment
Fields
Input Field | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
id - ID!
|
ID of the order to authorize payment for |
amount - MoneyInput
|
(PLUS ONLY) Amount to authorize |
Example
{
"clientMutationId": "xyz789",
"id": 4,
"amount": MoneyInput
}
OrderAuthorizePaymentPayload
Description
Autogenerated return type of OrderAuthorizePayment.
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
errors - [DisplayableError!]
|
|
orderPaymentStatus - OrderPaymentStatus!
|
The payment status of the order |
Example
{
"clientMutationId": "abc123",
"errors": [DisplayableError],
"orderPaymentStatus": OrderPaymentStatus
}
OrderCollectPartialPaymentInput
Description
Autogenerated input type of OrderCollectPartialPayment
Fields
Input Field | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
id - ID!
|
ID of the order to collect payment for |
amount - MoneyInput!
|
Amount to collect |
Example
{
"clientMutationId": "xyz789",
"id": "4",
"amount": MoneyInput
}
OrderCollectPartialPaymentPayload
Description
Autogenerated return type of OrderCollectPartialPayment.
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
errors - [DisplayableError!]
|
|
orderPaymentStatus - OrderPaymentStatus!
|
The payment status of the order |
Example
{
"clientMutationId": "xyz789",
"errors": [DisplayableError],
"orderPaymentStatus": OrderPaymentStatus
}
OrderCollectPaymentInput
OrderCollectPaymentPayload
Description
Autogenerated return type of OrderCollectPayment.
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
errors - [DisplayableError!]
|
|
orderPaymentStatus - OrderPaymentStatus!
|
The payment status of the order |
Example
{
"clientMutationId": "xyz789",
"errors": [DisplayableError],
"orderPaymentStatus": OrderPaymentStatus
}
OrderConnection
Description
The connection type for Order.
Fields
Field Name | Description |
---|---|
edges - [OrderEdge]
|
A list of edges. |
nodes - [Order]
|
A list of nodes. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
Example
{
"edges": [OrderEdge],
"nodes": [Order],
"pageInfo": PageInfo
}
OrderEdge
OrderPaymentStatus
Fields
Field Name | Description |
---|---|
createdAt - ISO8601DateTime!
|
|
orderId - ID!
|
The ID of the order |
paymentReferenceId - String!
|
The payment reference ID |
updatedAt - ISO8601DateTime!
|
Example
{
"createdAt": ISO8601DateTime,
"orderId": 4,
"paymentReferenceId": "xyz789",
"updatedAt": ISO8601DateTime
}
OrderRemovePaymentMethodInput
Description
Autogenerated input type of OrderRemovePaymentMethod
Example
{"clientMutationId": "abc123", "id": 4}
OrderRemovePaymentMethodPayload
Description
Autogenerated return type of OrderRemovePaymentMethod.
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
errors - [DisplayableError!]
|
|
orderId - ID
|
Example
{
"clientMutationId": "abc123",
"errors": [DisplayableError],
"orderId": "4"
}
OrderUpdateDueDateInput
Description
Autogenerated input type of OrderUpdateDueDate
Fields
Input Field | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
id - ID!
|
ID of the order for which to update the payment method |
date - ISO8601DateTime!
|
The new order due date |
Example
{
"clientMutationId": "abc123",
"id": 4,
"date": ISO8601DateTime
}
OrderUpdateDueDatePayload
Description
Autogenerated return type of OrderUpdateDueDate.
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
errors - [DisplayableError!]
|
|
orderId - ID
|
|
paymentDueDate - ISO8601DateTime
|
Example
{
"clientMutationId": "abc123",
"errors": [DisplayableError],
"orderId": "4",
"paymentDueDate": ISO8601DateTime
}
OrderVoidAuthorizationInput
OrderVoidAuthorizationPayload
Description
Autogenerated return type of OrderVoidAuthorization.
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
errors - [DisplayableError!]
|
|
orderId - ID
|
Example
{
"clientMutationId": "xyz789",
"errors": [DisplayableError],
"orderId": 4
}
PageInfo
Description
Information about pagination in a connection.
Fields
Field Name | Description |
---|---|
endCursor - String
|
When paginating forwards, the cursor to continue. |
hasNextPage - Boolean!
|
When paginating forwards, are there more items? |
hasPreviousPage - Boolean!
|
When paginating backwards, are there more items? |
startCursor - String
|
When paginating backwards, the cursor to continue. |
Example
{
"endCursor": "abc123",
"hasNextPage": false,
"hasPreviousPage": false,
"startCursor": "xyz789"
}
Percentage
Fields
Field Name | Description |
---|---|
percentage - Float!
|
Example
{"percentage": 123.45}
Price
Fields
Field Name | Description |
---|---|
amount - String!
|
|
currencyCode - CurrencyCode!
|
Example
{"amount": "abc123", "currencyCode": "USD"}
Product
PurchaseOption
Fields
Field Name | Description |
---|---|
billingPolicy - PurchaseOptionBillingPolicy!
|
|
description - String!
|
|
id - ID!
|
Example
{
"billingPolicy": PurchaseOptionBillingPolicy,
"description": "abc123",
"id": "4"
}
PurchaseOptionBillingPolicy
Fields
Field Name | Description |
---|---|
checkoutCharge - PurchaseOptionCheckoutCharge!
|
|
remainingBalanceChargeExactTime - ISO8601DateTime
|
|
remainingBalanceChargeTimeAfterCheckout - String
|
|
remainingBalanceChargeTrigger - PurchaseOptionRemainingBalanceChargeTrigger!
|
Example
{
"checkoutCharge": PurchaseOptionCheckoutCharge,
"remainingBalanceChargeExactTime": ISO8601DateTime,
"remainingBalanceChargeTimeAfterCheckout": "xyz789",
"remainingBalanceChargeTrigger": "ExactTime"
}
PurchaseOptionBillingPolicyInput
Fields
Input Field | Description |
---|---|
checkoutCharge - PurchaseOptionCheckoutChargeInput!
|
|
remainingBalanceChargeExactTime - ISO8601DateTime
|
|
remainingBalanceChargeTimeAfterCheckout - String
|
|
remainingBalanceChargeTrigger - PurchaseOptionRemainingBalanceChargeTrigger
|
Example
{
"checkoutCharge": PurchaseOptionCheckoutChargeInput,
"remainingBalanceChargeExactTime": ISO8601DateTime,
"remainingBalanceChargeTimeAfterCheckout": "abc123",
"remainingBalanceChargeTrigger": "ExactTime"
}
PurchaseOptionCheckoutCharge
Fields
Field Name | Description |
---|---|
type - PurchaseOptionCheckoutChargeType!
|
|
value - PurchaseOptionCheckoutChargeValue!
|
Example
{"type": "PERCENTAGE", "value": Percentage}
PurchaseOptionCheckoutChargeInput
Fields
Input Field | Description |
---|---|
type - PurchaseOptionCheckoutChargeType!
|
|
value - PurchaseOptionCheckoutChargeValueInput!
|
Example
{
"type": "PERCENTAGE",
"value": PurchaseOptionCheckoutChargeValueInput
}
PurchaseOptionCheckoutChargeType
Description
Purchase option checkout charge enum
Values
Enum Value | Description |
---|---|
|
The checkout charge is a percentage of the product or variant price. |
|
The checkout charge is a fixed price amount. |
Example
"PERCENTAGE"
PurchaseOptionCheckoutChargeValue
Description
The portion of the price to be charged at checkout.
Types
Union Types |
---|
Example
Percentage
PurchaseOptionCheckoutChargeValueInput
PurchaseOptionGroup
Fields
Field Name | Description |
---|---|
createdAt - ISO8601DateTime!
|
|
id - ID!
|
|
lineItemDescriptor - String!
|
The description of the purchase option group that will be displayed to the customer in the cart and checkout. |
merchantCode - String!
|
The merchant-facing code for the purchase option group. |
orders - OrderConnection!
|
|
productCount - Int!
|
|
productVariantCount - Int!
|
|
products - [Product!]!
|
The products in the purchase option group. Note that this only returns the first 250 products in the group. |
productsRequirePurchaseOption - Boolean!
|
Whether or not products in the purchase option group require a purchase option to be purchased. |
purchaseOptions - [PurchaseOption!]!
|
|
resourceAssignmentType - ResourceAssignment!
|
|
tags - [String!]!
|
|
variants - [Variant!]!
|
Example
{
"createdAt": ISO8601DateTime,
"id": "4",
"lineItemDescriptor": "xyz789",
"merchantCode": "abc123",
"orders": OrderConnection,
"productCount": 123,
"productVariantCount": 123,
"products": [Product],
"productsRequirePurchaseOption": false,
"purchaseOptions": [PurchaseOption],
"resourceAssignmentType": "PRODUCTS",
"tags": ["abc123"],
"variants": [Variant]
}
PurchaseOptionGroupAddProductVariantsInput
Description
Autogenerated input type of PurchaseOptionGroupAddProductVariants
Example
{
"clientMutationId": "abc123",
"id": 4,
"productVariantIds": ["4"]
}
PurchaseOptionGroupAddProductVariantsPayload
Description
Autogenerated return type of PurchaseOptionGroupAddProductVariants.
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
errors - [DisplayableError!]
|
|
purchaseOptionGroup - PurchaseOptionGroup
|
Purchase option group describing the terms of the sale for a product or gruop of products |
Example
{
"clientMutationId": "xyz789",
"errors": [DisplayableError],
"purchaseOptionGroup": PurchaseOptionGroup
}
PurchaseOptionGroupAddProductsInput
Description
Autogenerated input type of PurchaseOptionGroupAddProducts
Example
{
"clientMutationId": "xyz789",
"id": "4",
"productIds": [4]
}
PurchaseOptionGroupAddProductsPayload
Description
Autogenerated return type of PurchaseOptionGroupAddProducts.
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
errors - [DisplayableError!]
|
|
purchaseOptionGroupId - ID
|
ID of the purchase option group |
Example
{
"clientMutationId": "abc123",
"errors": [DisplayableError],
"purchaseOptionGroupId": 4
}
PurchaseOptionGroupAddTagsInput
Description
Autogenerated input type of PurchaseOptionGroupAddTags
Fields
Input Field | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
id - ID!
|
ID of the purchase option group to add products with specified tags to |
productTags - [String!]!
|
List of product tags to add to the purchase option group |
Example
{
"clientMutationId": "abc123",
"id": "4",
"productTags": ["xyz789"]
}
PurchaseOptionGroupAddTagsPayload
Description
Autogenerated return type of PurchaseOptionGroupAddTags.
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
errors - [DisplayableError!]
|
|
purchaseOptionGroupId - ID
|
ID of the purchase option group |
Example
{
"clientMutationId": "xyz789",
"errors": [DisplayableError],
"purchaseOptionGroupId": 4
}
PurchaseOptionGroupConnection
Description
The connection type for PurchaseOptionGroup.
Fields
Field Name | Description |
---|---|
edges - [PurchaseOptionGroupEdge]
|
A list of edges. |
nodes - [PurchaseOptionGroup]
|
A list of nodes. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
Example
{
"edges": [PurchaseOptionGroupEdge],
"nodes": [PurchaseOptionGroup],
"pageInfo": PageInfo
}
PurchaseOptionGroupEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - PurchaseOptionGroup
|
The item at the end of the edge. |
Example
{
"cursor": "xyz789",
"node": PurchaseOptionGroup
}
PurchaseOptionGroupInput
Fields
Input Field | Description |
---|---|
id - ID
|
|
merchantCode - String
|
|
lineItemDescriptor - String
|
|
productsRequirePurchaseOption - Boolean
|
|
purchaseOptionsToCreate - [PurchaseOptionInput!]
|
|
purchaseOptionsToUpdate - [PurchaseOptionInput!]
|
|
purchaseOptionsToDelete - [ID!]
|
Example
{
"id": "4",
"merchantCode": "abc123",
"lineItemDescriptor": "xyz789",
"productsRequirePurchaseOption": false,
"purchaseOptionsToCreate": [PurchaseOptionInput],
"purchaseOptionsToUpdate": [PurchaseOptionInput],
"purchaseOptionsToDelete": [4]
}
PurchaseOptionGroupRemoveProductVariantsInput
Description
Autogenerated input type of PurchaseOptionGroupRemoveProductVariants
Example
{
"clientMutationId": "abc123",
"id": "4",
"productVariantIds": ["4"]
}
PurchaseOptionGroupRemoveProductVariantsPayload
Description
Autogenerated return type of PurchaseOptionGroupRemoveProductVariants.
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
errors - [DisplayableError!]
|
|
removedProductVariantIds - [ID!]
|
IDs of the product variants that were removed from the purchase option group |
Example
{
"clientMutationId": "xyz789",
"errors": [DisplayableError],
"removedProductVariantIds": [4]
}
PurchaseOptionGroupRemoveProductsInput
Description
Autogenerated input type of PurchaseOptionGroupRemoveProducts
Example
{
"clientMutationId": "abc123",
"id": 4,
"productIds": ["4"]
}
PurchaseOptionGroupRemoveProductsPayload
Description
Autogenerated return type of PurchaseOptionGroupRemoveProducts.
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
errors - [DisplayableError!]
|
|
purchaseOptionGroupId - ID
|
ID of the purchase option group |
removedProductIds - [ID!]
|
IDs of the products that were removed from the purchase option group |
Example
{
"clientMutationId": "xyz789",
"errors": [DisplayableError],
"purchaseOptionGroupId": 4,
"removedProductIds": ["4"]
}
PurchaseOptionGroupRemoveTagsInput
Description
Autogenerated input type of PurchaseOptionGroupRemoveTags
Fields
Input Field | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
id - ID!
|
ID of the purchase option group to remove products with the associated tags from |
productTags - [String!]!
|
List of product tags to remove from the purchase option group |
Example
{
"clientMutationId": "abc123",
"id": 4,
"productTags": ["abc123"]
}
PurchaseOptionGroupRemoveTagsPayload
Description
Autogenerated return type of PurchaseOptionGroupRemoveTags.
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
errors - [DisplayableError!]
|
|
purchaseOptionGroupId - ID
|
ID of the purchase option group |
removedProductTags - [String!]
|
List of products tags that were removed from the purchase option group |
Example
{
"clientMutationId": "abc123",
"errors": [DisplayableError],
"purchaseOptionGroupId": "4",
"removedProductTags": ["abc123"]
}
PurchaseOptionInput
Fields
Input Field | Description |
---|---|
id - ID
|
|
description - String
|
|
billingPolicy - PurchaseOptionBillingPolicyInput
|
Example
{
"id": "4",
"description": "xyz789",
"billingPolicy": PurchaseOptionBillingPolicyInput
}
PurchaseOptionRemainingBalanceChargeTrigger
Description
Purchase option remaining balance charge trigger enum
Values
Enum Value | Description |
---|---|
|
At an exact time defined by the remaining_balance_charge_exact_time field. |
|
When there's no remaining balance to be charged after checkout. |
|
After the duration defined by the remaining_balance_charge_time_after_checkout field. |
Example
"ExactTime"
ResourceAssignment
Values
Enum Value | Description |
---|---|
|
Products will be manually assigned to the purchase option group |
|
Variants will be manually assigned to the purchase option group |
|
Products with the specified tags will be automatically assigned to the purchase option group |
Example
"PRODUCTS"
ResourceInput
String
Description
Represents textual data as UTF-8 character sequences. This type is most often used by GraphQL to represent free-form human-readable text.
Example
"xyz789"
UpdatePurchaseOptionGroupInput
Description
Autogenerated input type of UpdatePurchaseOptionGroup
Fields
Input Field | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
purchaseOptionGroupInput - PurchaseOptionGroupInput!
|
Input for the purchase option group to update |
Example
{
"clientMutationId": "xyz789",
"purchaseOptionGroupInput": PurchaseOptionGroupInput
}
UpdatePurchaseOptionGroupPayload
Description
Autogenerated return type of UpdatePurchaseOptionGroup.
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
errors - [DisplayableError!]
|
|
purchaseOptionGroup - PurchaseOptionGroup
|
The updated purchase option group |
Example
{
"clientMutationId": "abc123",
"errors": [DisplayableError],
"purchaseOptionGroup": PurchaseOptionGroup
}
Variant
Fields
Field Name | Description |
---|---|
id - ID!
|
The ID of the variant. Same as the Shopify Variant ID. |
Example
{"id": 4}