Skip to main content
Anchor to CustomerPaymentMethod

CustomerPaymentMethod

object

Requires read_customers access scope. Also: Requires read_customer_payment_methods scope.

A customer's payment method.

Anchor to Fields and connectionsFields and connections

•Customer

The customer to whom the payment method belongs.

•ID!non-null

The ID of this payment method.

•CustomerPaymentInstrument

The instrument for this payment method.

•DateTime

The time that the payment method was revoked.

•CustomerPaymentMethodRevocationReason

The revocation reason for this payment method.

Anchor to subscriptionContractssubscriptionContracts
•SubscriptionContractConnection!non-null

List Subscription Contracts.


Was this section helpful?

•query

Returns a CustomerPaymentMethod resource by its ID.


Was this section helpful?

•mutation

Creates a credit card payment method for a customer using a session id. These values are only obtained through card imports happening from a PCI compliant environment. Please use customerPaymentMethodRemoteCreate if you are not managing credit cards directly.

Arguments

•MailingAddressInput!required

The billing address.

•ID!required

The ID of the customer.

•String!required

The Cardserver session ID. Obtained by storing card data with Shopify's Cardsink. Exchanging raw card data for a session ID must be done in a PCI complaint environment.


Fields

Anchor to customerPaymentMethodcustomerPaymentMethod
•CustomerPaymentMethod

The customer payment method.

•Boolean

If the card verification result is processing. When this is true, customer_payment_method will be null.

•[UserError!]!non-null

The list of errors that occurred from executing the mutation.

•mutation

Updates the credit card payment method for a customer.

Arguments

•MailingAddressInput!required

The billing address.

•ID!required

The ID of the customer payment method.

•String!required

The Cardserver session ID.


Fields

Anchor to customerPaymentMethodcustomerPaymentMethod
•CustomerPaymentMethod

The customer payment method.

•Boolean

If the card verification result is processing. When this is true, customer_payment_method will be null.

•[UserError!]!non-null

The list of errors that occurred from executing the mutation.

•mutation

Creates a PayPal billing agreement for a customer.

Arguments

•MailingAddressInput

The billing address.

•String!required

The billing agreement ID from PayPal that starts with 'B-' (for example, B-1234XXXXX).

•ID!required

The ID of the customer.

•BooleanDefault:false

Whether the PayPal billing agreement is inactive.


Fields

Anchor to customerPaymentMethodcustomerPaymentMethod
•CustomerPaymentMethod

The customer payment method.

•[CustomerPaymentMethodUserError!]!non-null

The list of errors that occurred from executing the mutation.

•mutation

Updates a PayPal billing agreement for a customer.

Arguments

•MailingAddressInput!required

The billing address.

•ID!required

The ID of the customer payment method.


Fields

Anchor to customerPaymentMethodcustomerPaymentMethod
•CustomerPaymentMethod

The customer payment method.

•[CustomerPaymentMethodUserError!]!non-null

The list of errors that occurred from executing the mutation.

•mutation

Create a payment method from remote gateway identifiers. NOTE: This operation processes payment methods asynchronously. The returned payment method will initially have incomplete details. Developers must poll this payment method using customerPaymentMethod query until all payment method details are available, or the payment method is revoked (usually within seconds).

Arguments

•ID!required

The ID of the customer.

•CustomerPaymentMethodRemoteInput!required

Remote gateway payment method details.


Fields

Anchor to customerPaymentMethodcustomerPaymentMethod
•CustomerPaymentMethod

The customer payment method. Note that the returned payment method may initially be in an incomplete state. Developers should poll this payment method using the customerPaymentMethod query until all required payment details have been processed.

•[CustomerPaymentMethodRemoteUserError!]!non-null

The list of errors that occurred from executing the mutation.


Was this section helpful?

•interface

Was this section helpful?