Skip to main content
Anchor to orderCreateMandatePayment

orderCreateMandatePayment

mutation

Requires write_payment_mandate access scope. Also: The user must have pay_orders_by_vaulted_card permission. The API client must be installed on a Shopify Plus store to use the amount field.

Creates a payment for an Order using a stored PaymentMandate. A payment mandate represents the customer's authorization to charge their payment method for deferred payments, such as pre-orders or try-before-you-buy purchases.

The mutation processes the payment asynchronously and returns a Job for tracking the payment status. You can specify the payment amount to collect, and use the autoCapture argument to either immediately capture the payment or only authorize it for later capture. Each payment request requires a unique idempotencyKey to prevent duplicate charges. Subsequent calls with the same key return the original payment result rather than creating a new payment.

Learn more about deferred payments and payment mandates and idempotent requests.

•MoneyInput

The payment amount to collect.

•Boolean
Default:true

Whether the payment should be authorized or captured. If false, then the authorization of the payment is triggered.

•ID!
required

The ID of the order to collect the balance for.

•String!
required

A unique key to identify the payment request.

•ID!
required

The mandate ID used for payment.

•ID

The ID of the payment schedule to collect the balance for.


Was this section helpful?

Anchor to OrderCreateMandatePaymentPayload returnsOrderCreateMandatePaymentPayload returns

•Job

The async job used for charging the payment.

•String

The Unique ID for the created payment.

•[OrderCreateMandatePaymentUserError!]!
non-null

The list of errors that occurred from executing the mutation.


Was this section helpful?