Skip to main content

UpdatePaymentInput

Payment update data containing fields to be modified.

Extends the payment creation input with all fields made optional for partial updates. The order ID cannot be changed after payment creation. Only provided fields will be updated, others remain unchanged.

input UpdatePaymentInput {
  userId: Int
  anonymousId: Int
  paymentId: String
  amount: Int
  currency: String
  method: String
  status: PaymentStatuses
  addTransaction: CreateTransactionInput
}

Fields​

UpdatePaymentInput.userId ● Int scalar​

Authenticated user identifier for payment attribution and history tracking.

Links the payment to a specific authenticated user for user-specific payment history and account management. Must be a positive integer when provided.

UpdatePaymentInput.anonymousId ● Int scalar​

Anonymous user session identifier for guest checkout payments.

References the guest user session for payments made without authentication. Used for guest checkout tracking and order management. Must be a positive integer when provided.

UpdatePaymentInput.paymentId ● String scalar​

External payment identifier provided by the payment service provider for tracking.

Unique payment reference provided by the Payment Service Provider (PSP) for tracking and reconciliation. Used for payment status updates and transaction matching. Maximum length of 255 characters.

UpdatePaymentInput.amount ● Int scalar​

Payment amount in smallest currency unit (cents) for precise financial calculations.

The total amount to be paid expressed in the smallest denomination of the currency (e.g., cents for USD, pence for GBP). Must be a positive integer for precise financial calculations.

UpdatePaymentInput.currency ● String scalar​

ISO 4217 three-letter currency code for international financial transactions.

Three-letter currency code (e.g., USD, EUR, GBP) following ISO 4217 standard. Used for currency conversion and financial reporting. Must be exactly 3 uppercase letters.

UpdatePaymentInput.method ● String scalar​

Payment method code used by the payment service provider for transaction processing.

Specific payment method code used by the Payment Service Provider for processing this transaction (e.g., 'credit_card', 'paypal', 'bank_transfer'). Maximum length of 100 characters.

UpdatePaymentInput.status ● PaymentStatuses enum​

Initial payment processing status for the new payment record.

Sets the starting status for the payment lifecycle. Determines the initial state and available actions for the payment processing workflow.

UpdatePaymentInput.addTransaction ● CreateTransactionInput input​

Optional transaction to create alongside the payment for immediate processing.

When provided, creates an associated transaction record with the payment for immediate processing and tracking. Enables atomic creation of payment and initial transaction in a single operation.

Member Of​

paymentUpdate mutation