addVoucher Mutation

Description

Applies a voucher to a checkout.

mutation addVoucher($id: String!, $voucherId: String!) {
  addVoucher(id: $id, voucherId: $voucherId) {
    _id
    id
    configRef
    origin
    created
    shipping {
      status
      date
      method
      freeShippingThreshold
      tracking
      shopCollection
      weight
    }
    billing {
      status
      paymentDate
      refundDate
    }
    orderId
    note {
      date
      content
    }
    items {
      _id
      id
      quantity
      added
      total
      unavailable
    }
    buyer {
      _id
      email
      firstName
      id
      lastName
      name
      telephone
      organisation
      taxNumber
      isGuest
    }
    seller {
      _id
      id
      firstName
      lastName
      name
      email
      telephone
      taxNumber
    }
    updated
    expires
    status
    message
    totals {
      grand
      leftToPay
      discount
      itemsQuantity
      itemQuantity
      subtotal
      subtotalBeforeTaxes
      shipping
      tax
    }
    urls {
      checkout
      storefront
    }
    useSingleAddress
  }
}

Variables

{
    "id": "08a16b83-9094-4e89-8c05-2ccadd5c1c7e",
    "voucherId": "voucherId"
}

Response

{
    "addVoucher": {
        "_id": "0b8dac5ad1db1f0badc39557",
        "id": "example",
        "configRef": "807581c5b7ad68b9a0d142d9",
        "origin": "example",
        "created": 1746432492425,
        "shipping": {
            "status": "example",
            "date": 1745759867522,
            "method": "example",
            "freeShippingThreshold": 1.23,
            "tracking": "example",
            "shopCollection": true,
            "weight": "example"
        },
        "billing": {
            "status": "example",
            "paymentDate": 1751617497889,
            "refundDate": 1730812635543
        },
        "orderId": "example",
        "note": {
            "date": 1757344165704,
            "content": "example"
        },
        "items": [
            {
                "_id": "d2a9deee5ef31b5c49d5be36",
                "id": "be492f3b54c4b0fae0ebabf8",
                "quantity": 1.23,
                "added": 1756710768796,
                "total": 29.99,
                "unavailable": true
            }
        ],
        "buyer": {
            "_id": "98955ea8aed731b9052c7cd4",
            "email": "email@example.com",
            "firstName": "example",
            "id": 1.23,
            "lastName": "example",
            "name": "example",
            "telephone": "example",
            "organisation": "example",
            "taxNumber": "example",
            "isGuest": true
        },
        "seller": {
            "_id": "8b18b96195c18f65ba95d66e",
            "id": "example",
            "firstName": "example",
            "lastName": "example",
            "name": "example",
            "email": "email@example.com",
            "telephone": "example",
            "taxNumber": "example"
        },
        "updated": 1767744164044,
        "expires": 1787855234117,
        "status": "example",
        "message": "example",
        "totals": {
            "grand": 1.23,
            "leftToPay": 1.23,
            "discount": 0.1,
            "itemsQuantity": 1.23,
            "itemQuantity": 42,
            "subtotal": 1.23,
            "subtotalBeforeTaxes": 1.23,
            "shipping": 1.23,
            "tax": 1.23
        },
        "urls": {
            "checkout": "example",
            "storefront": "example"
        },
        "useSingleAddress": true
    }
}

Arguments

Name	Type	Description
id	String!	Checkout identifier string.
voucherId	String!	Voucher identifier or code.

Returns

Checkout!