CartSelectPaymentMethodInput
Input for cartSelectPaymentMethod (Intelligent Payment Methods). Method-centric: the buyer picks a category (BLIK, CARD, BANK_TRANSFER, ...) and the backend resolves the preferred provider from MerchantPaymentConfig (priority-sorted, merchant-configurable per shop). Optional preferredProvider + preferredInstrument enable instrument-level deep-link to the gateway hosted page (skips the default landing).
input CartSelectPaymentMethodInput {
cartId: ID!
methodType: PaymentMethodType!
preferredInstrument: String
preferredProvider: PaymentProvider
}
Fields
CartSelectPaymentMethodInput.cartId ● ID! non-null scalar
ID of the cart to update.
CartSelectPaymentMethodInput.methodType ● PaymentMethodType! non-null enum
Category of the payment method the buyer picked (matches PaymentMethod.type from availablePaymentMethods).
CartSelectPaymentMethodInput.preferredInstrument ● String scalar
Optional gateway-specific instrument code (blik, mb, c, 154, ...) from PaymentMethod.instruments[].code. Requires preferredProvider to be set — instrument codes are provider-specific. No restrictive format is enforced, since different gateways may use . / : / / in future codes.
CartSelectPaymentMethodInput.preferredProvider ● PaymentProvider enum
Optional override of PaymentMethod.preferredProvider. Pass a PaymentProvider enum value (PAYU, PRZELEWY24, ...) read off providersAvailable / PaymentInstrument.provider when the buyer explicitly picks a gateway. Symmetric with the output — forward instrument.provider straight back, no case conversion.
Member Of
cartSelectPaymentMethod mutation