Skip to main content

Mutation

The Mutation type is a special type that is used to write or modify data. A mutation's response reflects the data after it has been updated. While query fields are executed in parallel, mutation fields run in series. This ensures each operation completes before the next begins.

acceptAccountHolderCardProductApplicationOffer​

Accept an extended AccountHolderCardProductApplicationOffer.

Output:AccountHolderCardProductApplicationOffersPayload

acceptAndFinalizeCardPaymentDispute​

Accepts and finalizes a CardPaymentDispute.

Output:AcceptAndFinalizeCardPaymentDisputePayload

activateCardProductCreditPlan​

Activate a CreditPlan for a CardProduct.

Output:ActivateCardProductCreditPlanPayload

activateCollaborativeAuthorizationEndpoint​

Activate a CollaborativeAuthorizationEndpoint.

Output:ActivateCollaborativeAuthorizationEndpointPayload

activateFlexibleCredentialInstantCredit​

Activate Instant Credit on a FlexibleCredential for a bounded window, setting or topping up the available credit that gates authorizations during it. Asynchronous: returns the activation status in PENDING; poll flexibleCredentialInstantCreditActivation or await the completion webhook for the terminal result.

Output:FlexibleCredentialInstantCreditActivationPayload

activateInstallmentAgreementForTransactionEvent​

Activate an InstallmentAgreement for a Transaction by providing a TransactionEvent.

Output:ActivateInstallmentAgreementForTransactionEventPayload

activateNotificationTarget​

Reactivates a previously deactivated notification target.

Output:ActivateNotificationTargetPayload

Input Arguments

input: ActivateNotificationTargetInput!

The input to activate a notification target.

activatePaymentCard​

Activate a Payment Card.

Output:ActivatePaymentCardPayload

Input Arguments

addCollaborativeAuthorizationEndpoint​

Add a CollaborativeAuthorizationEndpoint for use in real-time transaction authorization.

You are able to create up to 5 CollaborativeAuthorizationEndpoints, but only one may be active at a time.

By default, the created endpoint is not active. You must call the activateCollaborativeAuthorizationEndpoint mutation.

Output:AddCollaborativeAuthorizationEndpointPayload

addExternalBankAccountFromTokenDeprecated​

Add a bank account for account holder using external token.

Use Mutation.addExternalBankAccountVerifiedThroughPlaid instead.

Output:AddExternalBankAccountFromTokenPayload

addExternalBankAccountVerifiedThroughFinicity​

Add a bank account for account holder using external token. (Finicity specific)

Output:AddExternalBankAccountFromTokenPayload

addExternalBankAccountVerifiedThroughPlaid​

Add a bank account for account holder using external token. (Plaid specific)

Output:AddExternalBankAccountFromTokenPayload

addExternalBankAccountVerifiedThroughPlaidUsingThirdPartyProcessorToken​

Add a bank account for account holder using external tokens. (Third Party with Plaid specific) This is only usable for specific products within the CONSUMER_CREDIT vertical.

Output:AddExternalBankAccountFromTokenPayload

addFundsToPaymentCardDeprecated​

Transfer funds from a funding account of the Organization to a payment card.

Transfer is deprecated in favor of initiateTransferFromFundingFinancialAccountToPaymentCardFinancialAccount

Output:AddFundsToPaymentCardPayload

Input Arguments

addNonVerifiedExternalUSFinancialBankAccount​

Add a non-verified US bank account for an account holder. Can only be used to initiateFundsWithdrawalACHTransfer

Output:AddNonVerifiedExternalUSFinancialBankAccountPayload

addPaymentCardToApplePayByDevicePushProvisioning​

Request encrypted and activation data required to push provision a PaymentCard directly from your mobile application to an Apple Pay enabled device.

Output:AddPaymentCardDigitalWalletTokenApplePayDevicePushProvisioningPayload

addPaymentCardToGooglePayByDevicePushProvisioning​

Request encrypted and activation data required to push provision a PaymentCard directly from your mobile application to a Google Pay enabled device.

Output:AddPaymentCardDigitalWalletTokenGooglePayPushProvisioningPayload

addSubscriptionsToNotificationTarget​

Adds subscriptions to a notification target.

Output:AddSubscriptionsToNotificationTargetPayload

Input Arguments

input: AddSubscriptionsToNotificationTargetInput!

The input to add subscriptions to a notification target.

addUserDefinedFieldDefinitionRelationship​

Adds a relationship between a UserDefinedFieldDefinition and the given entity type.

Output:UserDefinedFieldDefinitionPayload

addWebhookNotificationTarget​

Adds a new https target for webhook notifications.

Output:AddWebhookNotificationTargetPayload

Input Arguments

input: AddWebhookNotificationTargetInput!

The input to add a new webhook notification target.

approveCreditLimitDecrease​

Once a decision has been reached to approve a credit limit decrease, use this mutation to update the CreditLimitChangeRequest and provide the adverse action reason (if applicable) and other details.

Output:CreditLimitChangeRequestPayload

Input Arguments

approveCreditLimitIncrease​

Once a decision has been reached to approve a credit limit increase, use this decision to update the CreditLimitChangeRequest and provide the updated credit limit and other details.

Output:CreditLimitChangeRequestPayload

Input Arguments

approveCreditProductApplicationUnderwriting​

Approve a credit-based AccountHolderCardProductApplication.

Output:ApproveCreditProductApplicationUnderwritingPayload

assignFinancialBankAccountToBusiness​

Assigns a financial account to a business.

Output:AssignFinancialBankAccountToBusinessPayload

assignPaymentCardToFinancialAccount​

Assigns a PaymentCard to a FinancialAccount.

This is used in addition to the issuePreprintedPaymentCardFinancialAccountForApplication mutation.

Output:AssignPaymentCardToFinancialAccountPayload

attachCardProductVelocityRule​

Attach a VelocityRule to a CardProduct

Output:AttachCardProductVelocityRulePayload

attachFeeToCreditPlan​

Attach a fee to a CreditPlan.

Output:AttachFeeToCreditPlanPayload

Input Arguments

attachPaymentCardVelocityRule​

Attach a VelocityRule to a PaymentCard

Output:AttachPaymentCardVelocityRulePayload

attachRealtimeRiskRuleToCardProduct​

Attaches a realtime risk rule to the given Card Product. The risk rule will be evaluated in realtime for every authorization on a payment card issued under the card product.

Output:AttachRealtimeRiskRuleToCardProductPayload

attachRealtimeRiskRuleToFinancialAccount​

Attaches a realtime risk rule to the given Financial Account. The risk rule will be evaluated in realtime for every authorization.

Output:AttachRealtimeRiskRuleToFinancialAccountPayload

attachRealtimeRiskRuleToPaymentCard​

Attaches a realtime risk rule to the given Payment Card. The risk rule will be evaluated in realtime for every authorization.

Output:AttachRealtimeRiskRuleToPaymentCardPayload

attachRewardEarnRuleToProduct​

Attach a reward earn rule to a product.

Output:AttachRewardEarnRuleToProductPayload

attachRewardRedemptionConfigurationToProduct​

Attach Reward RewardRedemptionConfiguration to a CardProduct.

Output:AttachRewardRedemptionConfigurationToProductPayload

attachSpendRuleToCardProduct​

Attaches a spend rule to the given Card Product. The spend rule will be evaluated for every authorization on a payment card issued under the card product.

Output:AttachSpendRuleToCardProductPayload

attachSpendRuleToFinancialAccount​

Attaches a spend rule to the given FinancialAccount. The spend control rule will be evaluated for every authorization.

Output:AttachSpendRuleToFinancialAccountPayload

attachSpendRuleToPaymentCard​

Attaches a spend control rule to the given Payment Card. The spend control rule will be evaluated for every authorization.

Output:AttachSpendRuleToPaymentCardPayload

attachVelocityRuleToFinancialAccount​

Attach a VelocityRule to a FinancialAccount

Output:AttachVelocityRuleToFinancialAccountPayload

authorizeNetworkTokenDeprecated​

Authorizes a NetworkToken for later capture.

Use `authorizePaymentTransaction` with `credential: { networkToken: { ... } }`. See the migration guide: https://docs.highnote.com/docs/acquiring/payments/migrate-payment-mutations

Output:AuthorizeNetworkTokenPayload

Input Arguments

authorizePaymentCardDeprecated​

Authorizes a PaymentCard for later capture.

Use `authorizePaymentTransaction` with `credential: { paymentCard: { ... } }`. See the migration guide: https://docs.highnote.com/docs/acquiring/payments/migrate-payment-mutations

Output:AuthorizePaymentCardPayload

Input Arguments

authorizePaymentCardForPos​

Authorizes a PaymentCard for later capture for point of service.

Output:AuthorizePaymentCardForPosPayload

Input Arguments

authorizePaymentMethodTokenDeprecated​

Authorizes a PaymentMethodToken for later capture.

Use `authorizePaymentTransaction` with `credential: { paymentMethodToken: { ... } }`. See the migration guide: https://docs.highnote.com/docs/acquiring/payments/migrate-payment-mutations

Output:AuthorizePaymentMethodTokenPayload

Input Arguments

authorizePaymentTransaction​

Authorizes a payment for later capture.

Possible UserError codes

Any credential:

  • INVALID_CONTRACT_ID — No merchant configuration was found for this request.
  • INVALID_PAN — The card number failed validation or is not supported. For a paymentMethodToken, the card resolved from the token is validated the same way.
  • INVALID_PAYMENT_TRANSACTION_AMOUNT — The payment amount must be greater than zero.
  • MERCHANT_DESCRIPTOR_NOT_CONFIGURED — No merchant descriptor is configured for this merchant. Contact support.
  • IDEMPOTENCY_KEY_CONFLICT — A concurrent request with the same idempotency key is still being processed; retry once it completes.

When using the paymentCard credential:

  • INVALID_BILLING_COUNTRY_CODE — The cardholder billing country code is not a valid country code.
  • INVALID_SECURITY_CODE_FORMAT — The security code must contain only digits.
  • INVALID_SECURITY_CODE_LENGTH — The security code length is invalid for the card brand.

When using the networkToken credential:

  • INVALID_BILLING_COUNTRY_CODE — The cardholder billing country code is not a valid country code.
  • MISSING_CRYPTOGRAM — A cryptogram is required when a network token is provided.
  • INVALID_CRYPTOGRAM_FORMAT — The cryptogram is not in a valid format.

When using the paymentMethodToken credential:

  • INVALID_TOKEN — No card was found for the given payment method token.

For installment payments:

  • INVALID_PAYMENT_INITIATOR_FOR_INSTALLMENT — Installment payments require an installment payment initiator.
  • INVALID_INSTALLMENT_PAYMENT_NUMBER — The installment payment number cannot exceed the total number of installments.
  • INSTALLMENT_PAYMENTS_NOT_SUPPORTED — Installment payments are not supported for this card.
  • INVALID_INSTALLMENT_PAYMENT_LINK — The original payment for this installment link was not found, or its credentials do not match.
  • INVALID_TOTAL_INSTALLMENT_AMOUNT — The total installment amount must be greater than zero.
  • INVALID_AMOUNT_PER_INSTALLMENT — The amount per installment must be greater than zero.
  • INVALID_TOTAL_AMOUNT_FUNDED — The total amount funded cannot be negative.

For single-authorization / multiple-clearing:

  • SINGLE_AUTH_MULTI_CLEAR_FEATURE_NOT_ENABLED — Single-authorization/multiple-clearing is not enabled for this organization.
  • SINGLE_AUTH_MULTI_CLEAR_NOT_SUPPORTED_FOR_PROCESSOR — Single-authorization/multiple-clearing is not supported for this card's processor.

When providing enhancedData:

  • ENHANCED_DATA_NOT_ENABLED: Enhanced data is not enabled for your organization. Contact Highnote support to request enablement.
  • ENHANCED_DATA_NETWORK_NOT_SUPPORTED (field mastercard): Enhanced data for this card network is not yet supported. The payment is not processed.
  • ENHANCED_DATA_INVALID: The enhanced data cannot be accepted: visa was sent with neither a header field nor a line item; purchaseIdentifier was sent without purchaseIdentifierFormat; a text field is blank, contains characters other than printable ASCII, or contains a card number; an amount is in a currency other than the payment's; or visa enhanced data was sent for a card that is not a Visa card. Correct or remove the field named by the error path.
  • ENHANCED_DATA_FIELD_TOO_LONG: An enhanced data field is longer than the maximum length in its description. Shorten the field named by the error path.
  • INVALID_INPUT (field lineItems, quantity, taxRate, quantityDecimalPlaces or unitCostDecimalPlaces): More than 998 line items were sent; a line item's quantity or taxRate is greater than 9007199254740991; a line item's quantityDecimalPlaces or unitCostDecimalPlaces is greater than 4; or a line item's unitCostDecimalPlaces was sent without a unitCost.

Output:AuthorizePaymentTransactionPayload

Input Arguments

bindCardAuthenticationContactAddress​

Bind a postal address to a PaymentCard or a FinancialAccount for use during authentication, independent of the account holder's identity record.

Binding again supersedes the address contact in force and returns the result. An address contact and a channel contact are bound independently and do not affect each other.

A purpose must be enabled on the card product before it can be switched on here.

Output:BindCardAuthenticationContactAddressPayload

Input Arguments

input: BindCardAuthenticationContactAddressInput!

The address contact to bind.

bindCardAuthenticationContactChannel​

Bind an email address, a phone number, or both, to a PaymentCard for use during authentication, independent of the account holder's identity record.

Binding again supersedes the channel contact in force on the card and returns the result, so read the returned contact to confirm which channels are now in force. Channel and address contacts are bound independently and do not affect each other.

A purpose must be enabled on the card product before it can be switched on here.

Output:BindCardAuthenticationContactChannelPayload

Input Arguments

input: BindCardAuthenticationContactChannelInput!

The channel contact to bind.

cancelPaymentTransactionDeprecated​

Cancels remaining held authorized amount.

Use `reversePaymentTransaction`. See the migration guide: https://docs.highnote.com/docs/acquiring/payments/migrate-payment-mutations

Output:CancelPaymentTransactionPayload

Input Arguments

cancelPhysicalCardGroupOrder​

Cancels a group order, and all the fulfillments in it.

Output:PhysicalCardGroupOrderPayload

cancelPhysicalPaymentCardOrder​

Cancel an order for a physical payment card. This can only be called while the order is in the NEW state.

Output:CancelPhysicalPaymentCardPayload

cancelRequestedIdentityUpdate​

Cancels the RequestedIdentityUpdate. The individual or business has acknowledged the accuracy and correctness of the provided information.

Requested updates will not be applied.

Output:CancelRequestedIdentityUpdatePayload

cancelScheduledTransfer​

Cancel a scheduled transfer between financial accounts.

Output:CancelScheduledTransferPayload

Input Arguments

capturePaymentTransaction​

Captures a previously authorized payment.

UserError codes specific to enhancedData

This list covers only enhancedData; a capture can also return other UserError codes.

  • ENHANCED_DATA_NOT_ENABLED: Enhanced data is not enabled for your organization. Contact Highnote support to request enablement.
  • ENHANCED_DATA_NETWORK_NOT_SUPPORTED (field mastercard): Enhanced data for this card network is not yet supported. The payment is not processed.
  • ENHANCED_DATA_INVALID: The enhanced data cannot be accepted: visa was sent with neither a header field nor a line item; purchaseIdentifier was sent without purchaseIdentifierFormat; a text field is blank, contains characters other than printable ASCII, or contains a card number; an amount is in a currency other than the payment's; or visa enhanced data was sent for a card that is not a Visa card. Correct or remove the field named by the error path.
  • ENHANCED_DATA_FIELD_TOO_LONG: An enhanced data field is longer than the maximum length in its description. Shorten the field named by the error path.
  • INVALID_INPUT (field lineItems, quantity, taxRate, quantityDecimalPlaces or unitCostDecimalPlaces): More than 998 line items were sent; a line item's quantity or taxRate is greater than 9007199254740991; a line item's quantityDecimalPlaces or unitCostDecimalPlaces is greater than 4; or a line item's unitCostDecimalPlaces was sent without a unitCost.

Output:CapturePaymentTransactionPayload

Input Arguments

chargeNetworkTokenDeprecated​

One step authorization and capture of a NetworkToken.

Use `chargePaymentTransaction` with `credential: { networkToken: { ... } }`. See the migration guide: https://docs.highnote.com/docs/acquiring/payments/migrate-payment-mutations

Output:ChargeNetworkTokenPayload

Input Arguments

chargePaymentCardDeprecated​

One step authorization and capture of a PaymentCard.

Use `chargePaymentTransaction` with `credential: { paymentCard: { ... } }`. See the migration guide: https://docs.highnote.com/docs/acquiring/payments/migrate-payment-mutations

Output:ChargePaymentCardPayload

Input Arguments

chargePaymentCardForPos​

One step authorization and capture of a PaymentCard for point of service.

Output:ChargePaymentCardForPosPayload

Input Arguments

chargePaymentMethodTokenDeprecated​

One step authorization and capture of a PaymentMethodToken.

Use `chargePaymentTransaction` with `credential: { paymentMethodToken: { ... } }`. See the migration guide: https://docs.highnote.com/docs/acquiring/payments/migrate-payment-mutations

Output:ChargePaymentMethodTokenPayload

Input Arguments

chargePaymentOrder​

One step authorization and capture of an Order.

Output:ChargePaymentOrderPayload

Input Arguments

chargePaymentOrderFromPaymentMethodToken​

One step authorization and capture of an PaymentOrder.

Output:ChargePaymentOrderPayload

chargePaymentTransaction​

Authorizes and captures a payment in a single round trip.

Possible UserError codes

Any credential:

  • INVALID_CONTRACT_ID — No merchant configuration was found for this request.
  • INVALID_PAN — The card number failed validation or is not supported. For a paymentMethodToken, the card resolved from the token is validated the same way.
  • INVALID_PAYMENT_TRANSACTION_AMOUNT — The payment amount must be greater than zero.
  • MERCHANT_DESCRIPTOR_NOT_CONFIGURED — No merchant descriptor is configured for this merchant. Contact support.
  • IDEMPOTENCY_KEY_CONFLICT — A concurrent request with the same idempotency key is still being processed; retry once it completes.

When using the paymentCard credential:

  • INVALID_BILLING_COUNTRY_CODE — The cardholder billing country code is not a valid country code.
  • INVALID_SECURITY_CODE_FORMAT — The security code must contain only digits.
  • INVALID_SECURITY_CODE_LENGTH — The security code length is invalid for the card brand.

When using the networkToken credential:

  • INVALID_BILLING_COUNTRY_CODE — The cardholder billing country code is not a valid country code.
  • MISSING_CRYPTOGRAM — A cryptogram is required when a network token is provided.
  • INVALID_CRYPTOGRAM_FORMAT — The cryptogram is not in a valid format.

When using the paymentMethodToken credential:

  • INVALID_TOKEN — No card was found for the given payment method token.

For installment payments:

  • INVALID_PAYMENT_INITIATOR_FOR_INSTALLMENT — Installment payments require an installment payment initiator.
  • INVALID_INSTALLMENT_PAYMENT_NUMBER — The installment payment number cannot exceed the total number of installments.
  • INSTALLMENT_PAYMENTS_NOT_SUPPORTED — Installment payments are not supported for this card.
  • INVALID_INSTALLMENT_PAYMENT_LINK — The original payment for this installment link was not found, or its credentials do not match.
  • INVALID_TOTAL_INSTALLMENT_AMOUNT — The total installment amount must be greater than zero.
  • INVALID_AMOUNT_PER_INSTALLMENT — The amount per installment must be greater than zero.
  • INVALID_TOTAL_AMOUNT_FUNDED — The total amount funded cannot be negative.

For single-authorization / multiple-clearing:

  • SINGLE_AUTH_MULTI_CLEAR_NOT_SUPPORTED_FOR_CHARGE — Single-authorization/multiple-clearing is not supported on charge; authorize first, then capture.
  • SINGLE_AUTH_MULTI_CLEAR_NOT_SUPPORTED_FOR_PROCESSOR — Single-authorization/multiple-clearing is not supported for this card's processor.

When providing enhancedData:

  • ENHANCED_DATA_NOT_ENABLED: Enhanced data is not enabled for your organization. Contact Highnote support to request enablement.
  • ENHANCED_DATA_NETWORK_NOT_SUPPORTED (field mastercard): Enhanced data for this card network is not yet supported. The payment is not processed.
  • ENHANCED_DATA_INVALID: The enhanced data cannot be accepted: visa was sent with neither a header field nor a line item; purchaseIdentifier was sent without purchaseIdentifierFormat; a text field is blank, contains characters other than printable ASCII, or contains a card number; an amount is in a currency other than the payment's; or visa enhanced data was sent for a card that is not a Visa card. Correct or remove the field named by the error path.
  • ENHANCED_DATA_FIELD_TOO_LONG: An enhanced data field is longer than the maximum length in its description. Shorten the field named by the error path.
  • INVALID_INPUT (field lineItems, quantity, taxRate, quantityDecimalPlaces or unitCostDecimalPlaces): More than 998 line items were sent; a line item's quantity or taxRate is greater than 9007199254740991; a line item's quantityDecimalPlaces or unitCostDecimalPlaces is greater than 4; or a line item's unitCostDecimalPlaces was sent without a unitCost.

Output:ChargePaymentTransactionPayload

Input Arguments

closeExternalFinancialBankAccount​

Close previously added external bank account.

Output:CloseExternalFinancialBankAccountPayload

closePaymentCard​

Close a Payment Card and decline all future authorizations.

Output:ClosePaymentCardPayload

Input Arguments

closeTransactionBatch​

Closes the current TransactionBatch for payout, and opens a new TransactionBatch.

Output:CloseTransactionBatchPayload

Input Arguments

completeAcquiringThreeDSecureAuthenticationChallenge​

Completes a 3DSecure step-up challenge authentication. The associated PaymentMethodToken is resolved server-side from the credential.paymentMethodTokenId passed on the input — submit the session PMT returned by initiateAcquiringThreeDSecureAuthentication as AcquiringThreeDSecureChallengeRequired.

Output:CompleteAcquiringThreeDSecureAuthenticationChallengePayload

completePhysicalCardGroupOrder​

Completes a group order, marking it as ready to ship.

Output:PhysicalCardGroupOrderPayload

confirmCreditReportUnfrozen​

Confirm credit freeze is lifted for an AccountHolderCardProductApplication.

If a credit freeze was present during initial underwriting, confirm the freeze is no longer present and then use this mutation to restart underwriting.

Will return an error if the AccountHolderCardProductApplication is in a terminal state such as APPROVED, DENIED, or CLOSED.

Output:ConfirmCreditReportUnfrozenPayload

Input Arguments

confirmPayrollDeposit​

Confirm that the specified ACH deposit is a payroll deposit.

Output:ConfirmPayrollDepositPayload

Input Arguments

confirmRequestedIdentityUpdate​

Confirms the RequestedIdentityUpdate. The individual or business has acknowledged the accuracy and correctness of the supplied information.

Output:ConfirmRequestedIdentityUpdatePayload

confirmVerificationOfCreditProductApplicationForFraudAlert​

Confirm a credit-based AccountHolderCardProductApplication is verified in response to a fraud alert on the applicant's credit report.

If an applicant's credit report contains a fraud alert, verify the applicant did intend to initiate this application, and that their name, date of birth, and address are correct on the application. Then, call this mutation.

Will return an error if the AccountHolderCardProductApplication is in a terminal state such as APPROVED, DENIED, or CLOSED.

Output:ConfirmVerificationOfCreditProductApplicationForFraudAlertPayload

createAccountHolderCardProductApplication​

Create a new card product application for an AccountHolder.

Output:CreateAccountHolderCardProductApplicationPayload

createAccountSpendRule​

Creates a new spend rule that specifies which accounts are either allowed or blocked.

Output:CreateAccountSpendRulePayload

Input Arguments

createAccountTransactionCountSpendRule​

Creates a AccountTransactionCountSpendRule that limits the number of transactions on an account.

Output:CreateAccountTransactionCountSpendRulePayload

createAmountLimitSpendRule​

Creates a new spend rule that limits the amount of authorizations.

Output:CreateAmountLimitSpendRulePayload

Input Arguments

createAuthorizedUserCardProductApplication​

Create a new card product application for an AuthorizedUser.

Output:CreateAuthorizedUserCardProductApplicationPayload

createBusiness​

Create a new Business.

Output:CreateBusinessPayload

Input Arguments

createCardDataInputCapabilitySpendRule​

Creates a CardDataInputCapabilitySpendRule that allows or blocks a CardDataInputCapability.

Output:CreateCardDataInputCapabilitySpendRulePayload

Mints a secure upload URL for one evidence file on a CardPaymentDispute evidence upload session. Any evidenceType is accepted.

Output:CreateCardPaymentDisputeEvidenceUploadLinkPayload

createCardProduct​

Creates a new Card Product.

Output:CreateCardProductPayload

Input Arguments

createCardProductCreditPlan​

Create a CreditPlan for a CardProduct based on a CreditPlanTemplate. For plans with a CreditBalanceType of INSTALLMENT, please use createCardProductInstallmentCreditPlan.

Output:CreateCardProductCreditPlanPayload

Input Arguments

createCardProductInstallmentCreditPlan​

Create a CreditPlan with a CreditBalanceType of INSTALLMENT for a CardProduct based on a CreditPlanTemplate.

Output:CreateCardProductInstallmentCreditPlanPayload

createCardProductWithTemplate​

Creates a card product from a template.

Note: This feature is only available in the TEST environment.

Output:CreateCardProductWithTemplatePayload

createCardTransactionProcessingTypeConditionSpendRule​

Creates a CardTransactionProcessingTypeConditionSpendRule that allows or blocks a CardTransactionProcessingType.

Output:CreateCardTransactionProcessingTypeConditionSpendRulePayload

createChargeCreditCardProductConfiguration​

Create a CreditCardProductConfiguration for a charge CardProduct, specifying details about the number of days until an account ages into states like DELINQUENT, SUSPENDED, and CLOSING, what is included in the minimum payment, and how repayments are applied.

Output:CreateCreditCardProductConfigurationPayload

createCheckPaymentDocumentUploadSession​

Creates a document upload session for check documents.

Output:CreateCheckPaymentDocumentUploadSessionPayload

createConditionalRuleSetSpendRule​

Creates a ConditionalRuleSetSpendRule that combines the results of multiple spend rules.

Output:CreateConditionalRuleSetSpendRulePayload

createCountLimitSpendRule​

Creates a new spend rule that limits the number of allowed transactions.

Output:CreateCountLimitSpendRulePayload

Input Arguments

createCreditLimitChangeRequest​

Create a CreditLimitChangeRequest, to track status and ultimately decision it.

Output:CreditLimitChangeRequestPayload

createCreditLimitPercentageSpendRule​

Creates a CreditLimitPercentageSpendRule that limits the amount a transaction can be authorized for to a percentage of the credit limit.

Output:CreateCreditLimitPercentageSpendRulePayload

createCVVSpendRule​

Creates a new spend rule that specifies if the result of a CVV check should be approved or declined.

Output:CreateCVVSpendRulePayload

Input Arguments

createDaysWithinAccountCreateDateSpendRule​

Creates a DaysWithinAccountCreateDateSpendRule that allows for spending up to a specified number of days since the create date of the card's FinancialAccount.

Output:CreateDaysWithinAccountCreateDateSpendRulePayload

createDaysWithinCardCreateDateSpendRule​

Creates a DaysWithinCardCreateDateSpendRule that allows for spending up to a specified number of days since the create date of the PaymentCard.

Output:CreateDaysWithinCardCreateDateSpendRulePayload

createDepositAmountLimitSpendRule​

Creates a DepositAmountLimitSpendRule that limits the amount of authorizations.

Output:CreateDepositAmountLimitSpendRulePayload

createDepositCountLimitSpendRule​

Creates a new DepositCountLimitSpendRule that limits the number of authorizations.

Output:CreateDepositCountLimitSpendRulePayload

createDepositProcessingNetworkSpendRule​

Creates a new DepositProcessingNetworkSpendRule which allows or blocks an ATM processing network.

Output:CreateDepositProcessingNetworkSpendRulePayload

Create a link to upload a document to Highnote.

Output:CreateDocumentUploadLinkPayload

Input Arguments

createGlobalNote​

Creates a new GlobalNote for an entity.

Output:GlobalNotePayload

Input Arguments

createMastercardFraudScoreSpendRule​

Creates a MastercardFraudScoreSpendRule that limits the acceptable Mastercard Fraud Score for transactions.

Output:CreateMastercardFraudScoreSpendRulePayload

createMaximumAmountVarianceOnCreditLimitSpendRule​

Creates a MaximumAmountVarianceOnCreditLimitSpendRule that allows transactions up to a specified Amount over the credit limit.

Output:CreateMaximumAmountVarianceOnCreditLimitSpendRulePayload

createMaximumAmountVarianceOnPseudoBalanceSpendRule​

Creates a MaximumAmountVarianceOnPseudoBalanceSpendRule that allows for spending up to a specified Amount above the account's original balance.

Output:CreateMaximumAmountVarianceOnPseudoBalanceSpendRulePayload

createMaximumPercentVarianceOnCreditLimitSpendRule​

Creates a MaximumPercentVarianceOnCreditLimitSpendRule that allows transactions up to a specified percentage over the credit limit.

Output:CreateMaximumPercentVarianceOnCreditLimitSpendRulePayload

createMaximumPercentVarianceOnPseudoBalanceSpendRule​

Creates a MaximumPercentVarianceOnPseudoBalanceSpendRule that allows for spending up to a specified percentage over the account's original balance.

Output:CreateMaximumPercentVarianceOnPseudoBalanceSpendRulePayload

createMerchantCategorySpendRule​

Creates a new spend rule that specifies the merchant categories that are either allowed or blocked during authorizations.

Output:CreateMerchantCategorySpendRulePayload

createMerchantCountrySpendRule​

Creates a new spend rule that specifies the merchant countries that are either allowed or blocked during authorizations.

Output:CreateMerchantCountrySpendRulePayload

createMerchantIdentifierSpendRule​

Creates a new spend rule that specifies which merchant identifiers (MIDs) are either allowed or blocked.

Output:CreateMerchantIdentifierSpendRulePayload

createMinimalUSBusinessAccountHolder​

Create a new USBusinessAccountHolder with minimal information.

Note: The following mutation may not be sufficient for your CardProduct.

Output:CreateMinimalUSBusinessAccountHolderPayload

createMinimumAmountLimitSpendRule​

Creates a MinimumAmountLimitSpendRule that only allows transactions for a specified amount.

Output:CreateMinimumAmountLimitSpendRulePayload

createOneTimeACHTransfer​

Create a one time ACH transfer between financial accounts.

Output:CreateOneTimeACHTransferPayload

Input Arguments

createPanEntryModeSpendRule​

Creates a PanEntryModeSpendRule that allows or blocks a PanEntryMode.

Output:CreatePanEntryModeSpendRulePayload

Input Arguments

createPaymentOrder​

Creates a new PaymentOrder.

Output:CreatePaymentOrderPayload

Input Arguments

createPhysicalCardGroupOrder​

Creates a new group order that can be used to ship multiple physical cards to the same location.

Output:PhysicalCardGroupOrderPayload

createPhysicalCardGroupOrderWithValidatedAddressDeprecated​

Creates a new group order that can be used to ship multiple physical cards to the same validated address.

Use `createPhysicalCardGroupOrderWithValidatedAddressToken` instead.

Output:PhysicalCardGroupOrderPayload

createPhysicalCardGroupOrderWithValidatedAddressToken​

Creates a new group order that can be used to ship multiple physical cards to the same validated address.

Output:PhysicalCardGroupOrderPayload

createPointOfServiceCategorySpendRule​

Creates a new spend rule that specifies which Point of Service (POS) categories are either allowed or blocked.

Output:CreatePointOfServiceCategorySpendRulePayload

createPostalCodeVerificationSpendRule​

Creates a new spend rule that specifies which address verification postal codes are either allowed or blocked.

Output:CreatePostalCodeVerificationSpendRulePayload

createPricingPlan​

Creates a new PricingPlan for a specific entity with the provided rules. New plans are created in a DRAFT state by default.

Output:CreatePricingPlanPayload

Input Arguments

input: CreatePricingPlanInput!

The input details for the pricing plan.

createRecurringACHTransfer​

Create a recurring ACH transfer between financial accounts.

Output:CreateRecurringACHTransferPayload

Input Arguments

createReusablePaymentMethodToken​

Create a reusable payment method from a tokenized payment method.

Output:CreateReusablePaymentMethodTokenPayload

createRevolvingCreditCardProductConfiguration​

Create a CreditCardProductConfiguration for a revolving CardProduct, specifying details about the number of days until an account ages into states like DELINQUENT, SUSPENDED, and CLOSING, what is included in the minimum payment, and how repayments are applied.

Output:CreateCreditCardProductConfigurationPayload

createRewardDefaultEarnRule​

Creates a new RewardDefaultEarnRule.

Output:CreateRewardDefaultEarnRulePayload

Input Arguments

createRewardMerchantCategoryEarnRule​

Creates a new RewardMerchantCategoryEarnRule.

Output:CreateRewardMerchantCategoryEarnRulePayload

createRewardPointsAdjustment​

Manually Deduct reward points from reward point balance.

Output:RewardPointsTransferPayload

createRewardRedemptionConfiguration​

Creates a new RewardRedemptionConfiguration.

Output:CreateRewardRedemptionConfigurationPayload

createSecretAPIKey​

Creates a new Secret API Key.

Output:CreateSecretAPIKeyPayload

Input Arguments

createStreetAddressSpendRule​

Creates a new spend rule that specifies if the result of a street address verification should be approved or declined.

Note Street address verifications only verify a street number. Use createPostalCodeVerificationSpendRule to change how postal codes are verified.

Output:CreateStreetAddressSpendRulePayload

createUnifiedFundsTransferQuote​

Starts the process by creating a UnifiedFundsTransferQuote, which the end user can then accept.

Once the quote is accepted, call initiateUnifiedFundsTransfer with the UnifiedFundsTransferQuote.id to initiate the transfer.

Output:CreateUnifiedFundsTransferQuotePayload

createUSBusinessAccountHolder​

Create a new USBusinessAccountHolder.

Output:CreateUSBusinessAccountHolderPayload

createUSBusinessAccountHolderFromToken​

Create a new USBusinessAccountHolder from tokenized data.

Output:CreateUSBusinessAccountHolderFromTokenPayload

createUserDefinedField​

Creates a UserDefinedField.

Output:UserDefinedFieldPayload

Input Arguments

createUserDefinedFieldDefinition​

Creates a UserDefinedFieldDefinition.

Output:UserDefinedFieldDefinitionPayload

createUSPersonAccountHolder​

Create a new USPersonAccountHolder.

Output:CreateUSPersonAccountHolderPayload

Input Arguments

createUSPersonAccountHolderFromToken​

Create a new USPersonAccountHolder from tokenized data.

Output:CreateUSPersonAccountHolderFromTokenPayload

createUSPersonAuthorizedUser​

Create a new USPersonAuthorizedUser.

Output:CreateUSPersonAuthorizedUserPayload

createUSPersonAuthorizedUserFromToken​

Create a new USPersonAuthorizedUser from tokenized data.

Output:CreateUSPersonAuthorizedUserFromTokenPayload

createVelocityRule​

Create a VelocityRule

Output:CreateVelocityRulePayload

Input Arguments

createVisaRiskScoreSpendRule​

Creates a VisaRiskScoreSpendRule that limits the acceptable Visa Risk Score for transactions.

Output:CreateVisaRiskScoreSpendRulePayload

deactivateCollaborativeAuthorizationEndpoint​

Deactivate a CollaborativeAuthorizationEndpoint.

Output:DeactivateCollaborativeAuthorizationEndpointPayload

deactivateNotificationTarget​

Deactivates a notification target.

Output:DeactivateNotificationTargetPayload

Input Arguments

input: DeactivateNotificationTargetInput!

The input to deactivate a notification target.

deleteCustomFields​

Deletes all CustomFields for an object.

Output:CustomFieldsPayload

Input Arguments

deleteSpendRule​

Deletes an existing spend rule.

Output:DeleteSpendRulePayload

Input Arguments

deleteVelocityRule​

Deletes an existing velocity rule.

Output:DeleteVelocityRulePayload

Input Arguments

denyCreditLimitDecrease​

Once a decision has been reached to deny a credit limit decrease, use this mutation to update the CreditLimitChangeRequest and provide any customer information collected.

Output:CreditLimitChangeRequestPayload

Input Arguments

denyCreditLimitIncrease​

Once a decision has been reached to deny a credit limit increase, use this mutation to update the CreditLimitChangeRequest and provide the adverse action reason (if applicable) and other details.

Output:CreditLimitChangeRequestPayload

Input Arguments

denyCreditProductApplicationUnderwriting​

Deny a credit-based AccountHolderCardProductApplication.

Output:DenyCreditProductApplicationUnderwritingPayload

detachCardProductVelocityRule​

Detach a VelocityRule from a CardProduct

Output:DetachCardProductVelocityRulePayload

detachPaymentCardVelocityRule​

Detach a VelocityRule from a PaymentCard

Output:DetachPaymentCardVelocityRulePayload

detachRealtimeRiskRuleFromCardProduct​

Detaches, or removes, a realtime risk rule from the given Card Product. The risk rule will not be evaluated for future authorizations on a payment card issued under the card product.

Output:DetachRealtimeRiskRuleFromCardProductPayload

detachRealtimeRiskRuleFromFinancialAccount​

Detaches, or removes, a realtime risk rule from the given Financial Account. The risk rule will not be evaluated for future authorizations.

Output:DetachRealtimeRiskRuleFromFinancialAccountPayload

detachRealtimeRiskRuleFromPaymentCard​

Detaches, or removes, a realtime risk rule from the given Payment Card. The risk rule will not be evaluated for future authorizations.

Output:DetachRealtimeRiskRuleFromPaymentCardPayload

detachSpendRuleFromCardProduct​

Detaches, or removes, a spend rule from the given Card Product. The spend rule will not be evaluated for future authorizations on a payment card issued under the card product.

Output:DetachSpendRuleFromCardProductPayload

detachSpendRuleFromFinancialAccount​

Detaches, or removes, a spend rule from the given FinancialAccount. The spend rule will not be evaluated for future authorizations.

Output:DetachSpendRuleFromFinancialAccountPayload

detachSpendRuleFromPaymentCard​

Detaches, or removes, a spend rule from the given Payment Card. The spend rule will not be evaluated for future authorizations.

Output:DetachSpendRuleFromPaymentCardPayload

detachVelocityRuleFromFinancialAccount​

Detach a VelocityRule from a FinancialAccount

Output:DetachVelocityRuleFromFinancialAccountPayload

disableAuthorizedUserFeature​

Disable the authorized user feature for a CardProduct.

Output:DisableAuthorizedUserFeaturePayload

enableAuthorizedUserFeature​

Enable the authorized user feature for a CardProduct.

Output:EnableAuthorizedUserFeaturePayload

Input Arguments

enableCollaborativeApplicationUnderwritingFeature​

Enable the Collaborative Application Decisioning feature for a CardProduct. This feature is available for credit products: COMMERCIAL_CREDIT, COMMERCIAL_CREDIT_PAY_IN_FULL, CONSUMER_CREDIT and FLEET. If this feature is enabled, every application waits for you to submit the underwriting decision through the API, and remains pending until then.

Output:EnableCollaborativeApplicationUnderwritingFeaturePayload

enableCollaborativeAuthorizationFeature​

Enable the collaborative authorization feature for a CardProduct.

Output:EnableCollaborativeAuthorizationFeaturePayload

enableCreditCardFeature​

Enable a credit card feature for a CardProduct. For example, REVOLVING or CHARGE. This feature is only available for the COMMERCIAL_CREDIT and CONSUMER_CREDIT CardProductVerticals.

Output:EnableCreditCardFeaturePayload

Input Arguments

enableOnDemandFundingFeature​

Enable the on-demand funding feature for a CardProduct. If this feature is enabled, on-demand funding source is supported on FinancialAccount of a CardProduct.

Note: Enabling this feature is only supported in the TEST environment.

Output:EnableOnDemandFundingFeaturePayload

endDocumentUploadSession​

Ends the session. The session no longer accepts additional files to be uploaded.

Output:EndDocumentUploadSessionPayload

Input Arguments

forceCapturePaymentTransaction​

Force Captures a payment.

Output:CapturePaymentTransactionPayload

forceStandaloneCapturePayment​

Standalone force-capture for an arbitrary amount with no prior authorization. Restricted to allowlisted organizations. Emits a clearing-only forced-post entry; no real-time auth message is sent to the network. Visa and Mastercard only.

Output:CapturePaymentTransactionPayload

generateAppleWebPushProvisioningToken​

Generate a JWT token for Apple Pay Web Push Provisioning session initiation.

Output:GenerateAppleWebPushProvisioningTokenPayload

generateBusinessAccountHolderClientToken​

Generate a token for use in a client-side integration to manage a business account holder.

Expiry: 15 minutes

Output:GenerateBusinessAccountHolderClientTokenPayload

generateCreateScheduledTransferClientToken​

Generate a token for use in a client-side integration to create a scheduled transfer.

Expiry: 15 minutes

Output:GenerateCreateScheduledTransferClientTokenPayload

generateDirectDepositDetailClientToken​

Generate a token for use in a client-side integration for a specific Financial Account Direct Deposit Details.

Expiry: 15 minutes

Output:GenerateDirectDepositDetailClientTokenPayload

generateDocumentUploadClientToken​

Generate a token for use in a client-side integration to orchestrate document uploads.

Expiry: 15 minutes

Output:GenerateDocumentUploadClientTokenPayload

generateExternalBankAccountDetailClientToken​

Generate a token for use in a client-side integration for a specific Financial Account Direct Deposit Details.

Expiry: 15 minutes

Output:GenerateExternalBankAccountDetailClientTokenPayload

generateFinancialAccountSingleUseClientToken​

Generate a Single Use Client Token for use in a client-side integration for a specific Financial Account.

generateFinancialAccountSingleUseClientToken can only be called once provisioned a restricted key after a security audit.

In Test, Highnote Customer Service can grant a restricted key without a security audit.

In Live, please reach out to Highnote Customer Service to initiate the audit.

Output:GenerateFinancialAccountSingleUseClientTokenPayload

generateInitiateSecureDepositClientToken​

Generate a token for use in a client-side integration to initiate a secure deposit.

Expiry: 15 minutes

Output:GenerateInitiateSecureDepositClientTokenPayload

generatePaymentCardClientToken​

Generate a token for use in a client-side integration for a specific Payment Card.

Expiry: 15 minutes

Output:GeneratePaymentCardClientTokenPayload

generatePaymentMethodTokenizationClientToken​

Generate a client token for use in the Secure Inputs SDK when tokenizing a payment method.

Expiry: 30 minutes

Output:GeneratePaymentMethodTokenizationClientTokenPayload

generatePersonAccountHolderClientToken​

Generate a token for use in a client-side integration to manage a person account holder.

Expiry: 15 minutes

Output:GeneratePersonAccountHolderClientTokenPayload

generatePersonAuthorizedUserClientToken​

Generate a token for use in a client-side integration to manage a person authorized user.

Expiry: 15 minutes

Output:GeneratePersonAuthorizedUserClientTokenPayload

generateRiskApplicationSDKSessionToken​

Generate risk application sdk session token

Output:GenerateRiskApplicationSDKSessionTokenPayload

generateRiskClientToken​

Generate risk client token

Output:GenerateRiskClientTokenPayload

Input Arguments

generateScheduledTransferClientToken​

Generate a token for use in a client-side integration for a scheduled transfer.

Expiry: 15 minutes

Output:GenerateSecureDepositClientTokenPayload

generateSecureDepositClientToken​

Generate a token for use in a client-side integration for a secure deposit.

Expiry: 15 minutes

Output:GenerateSecureDepositClientTokenPayload

generateTokenizeAccountHolderClientToken​

Generate a token to tokenize input for a new account holder.

The resulting token can be used with createUSPersonAccountHolderFromToken

Expiry: 15 minutes

Output:GenerateTokenizeAccountHolderClientTokenPayload

generateTokenizeAuthorizedUserClientToken​

Generate a token to tokenize input for a new authorized user.

The resulting token can be used with createUSPersonAuthorizedUserFromToken

Expiry: 15 minutes

Output:GenerateTokenizeAuthorizedUserClientTokenPayload

generateVerifiedExternalBankAccountLinkToken​

Generate a token for account holder to link external bank accounts

Output:GenerateVerifiedExternalBankAccountLinkTokenPayload

incrementalAuthorizePaymentTransaction​

Incrementally authorizes an existing PaymentTransaction, increasing its authorized amount.

Output:IncrementalAuthorizePaymentTransactionPayload

initiateAchTransfer​

Push or pull funds between a Highnote FinancialAccount and an external financial account (ExternalFinancialBankAccount or NonVerifiedExternalUSFinancialBankAccount) via ACH transfer.

Output:InitiateAchTransferPayload

Input Arguments

initiateAcquiringThreeDSecureAuthentication​

Initiates a 3-D Secure authentication session for a stored PaymentMethodToken (credential.paymentMethodTokenId) or a card supplied directly with the session token from the data-exchange leg (credential.paymentCardCredential). Cardholder-Initiated Transactions (CIT) only — browser fingerprint is required, collected via DDC and posted by the cardholder browser between initiateAcquiringThreeDSecureDataExchange and this call. Outcome can be frictionless SUCCESS, step-up CHALLENGE, or FAIL. Merchant-Initiated (3RI) authentication is handled internally by Highnote's transaction layer and is not exposed via GraphQL.

Output:InitiateAcquiringThreeDSecureAuthenticationPayload

initiateAcquiringThreeDSecureDataExchange​

Begins a 3-D Secure authentication by returning the Device Data Collection (DDC) credentials the cardholder's browser must post before calling initiateAcquiringThreeDSecureAuthentication. Supply the card either as a stored PaymentMethodToken (credential.paymentMethodTokenId) or directly (credential.paymentCard); the response carries a threeDSecureSessionToken whose id threads through the subsequent authentication legs.

Output:InitiateAcquiringThreeDSecureDataExchangePayload

initiateAddWiredFundsToFinancialAccount​

Initiate add funds to a FinancialAccount via wire.

Output:InitiateAddWiredFundsPayload

initiateCardPaymentDisputeEvidenceUpload​

Opens a document upload session for the active stage of a CardPaymentDispute. Upload URLs are minted per file via createCardPaymentDisputeEvidenceUploadLink.

Output:InitiateCardPaymentDisputeEvidenceUploadPayload

initiateCustomerCardTransactionDispute​

Initiate PaymentCardTransactionDispute on a valid card transaction event.

Output:PaymentCardTransactionDisputePayload

initiateFinancialAccountCreditLimitUpdateFromProductFunding​

Update Credit Limit for the account holder from product funding account. Account Holder financial account has FleetCardFeature as enabled Product has Product Funding Feature as enabled

Output:InitiateFinancialAccountCreditLimitUpdateFromProductFundingPayload

initiateFinancialAccountPseudoBalanceUpdateDeprecated​

Set and update the pseudo balance on your customers' financial account.

The pseudo balance is the lifetime limit for this financial account. Highnote checks the pseudo balance during the transaction processing and will decline authorizations that would cause the current balance to exceed the pseudo balance. For example, if you allocate a pseudo balance of $100 for this finanacial account, the financial account already has a balance of $100 and the account holder attempts to authorize $1, Highnote would decline the authorization.

Use updatePseudoBalance instead.

Output:FinancialAccountPseudoBalanceUpdatePayload

initiateFundPaymentCardFinancialAccountTransferDeprecated​

Add funds to account holder FinancialAccount from funding account . Account holder financial account that has PrepaidCardAccountFeature or DebitCardAccountFeature as enabled Origination account is either a Product financial account that has ProductFundingFeature as enabled or account that has CardFundingAccountFeature enabled

Use initiateTransferFromFundingFinancialAccountToPaymentCardFinancialAccount instead.

Output:InitiateFundPaymentCardFinancialAccountTransferPayload

initiateFundsDepositACHTransfer​

Send funds from an ExternalFinancialAccount to a FinancialAccount using ACH.

ACH is a method of transferring funds between banks.

Output:InitiateFundsDepositACHTransferPayload

initiateFundsWithdrawalACHTransfer​

Send funds from a FinancialAccount to an ExternalFinancialAccount using ACH.

ACH is a method of transferring funds between banks.

Output:InitiateFundsWithdrawalACHTransferPayload

initiateOnDemandPricingCharge​

Initiates an on-demand pricing charge to an acquiring entity (ISO, merchant, payfac). The payee is derived from the API key used to make the request.

Output:InitiateOnDemandPricingChargePayload

Input Arguments

input: InitiateOnDemandPricingChargeInput!

The input details for the on-demand pricing charge.

initiateOrganizationReport​

Initiates an asynchronous operation to generate a report for an Organization.

Output:InitiateOrganizationReportPayload

Input Arguments

initiatePayrollAdvance​

Move funds from an employer FinancialAccount to an employee FinancialAccount as a payroll advance. Requires the following FinancialAccountFeatureTypes to be enabled:

  • PayrollEmployerAdvanceFinancialAccountFeature on the employer FinancialAccount
  • PayrollAdvanceFinancialAccountFeature on the employee FinancialAccount

Output:InitiatePayrollAdvancePayload

Input Arguments

initiatePhysicalCheckPayment​

Initiate the process of sending a physical check.

Output:InitiatePhysicalCheckPaymentPayload

initiateSecureDepositACHTransfer​

Transfer funds from an ExternalFinancialAccount to an internal FinancialAccount via ACH for a secure deposit.

ACH is a method of transferring funds between banks.

Output:InitiateSecureDepositACHTransferPayload

initiateTransferBetweenFinancialAccounts​

Transfer funds between FinancialAccounts.

  • When the transfer purpose is REWARD or EARNED_CREDIT.

    • Origination account is either a Business financial account with ProductFundingFeature enabled, or an account with CardFundingAccountFeature enabled.
    • Payment Card Holder financial account has PrepaidCardAccountFeature or DebitCardAccountFeature enabled.
  • When the transfer purpose is REWARD_REVERSAL or EARNED_CREDIT_REVERSAL.

    • Payment Card Holder financial account has PrepaidCardAccountFeature or DebitCardAccountFeature enabled.
    • Target account is either a Business financial account with ProductFundingFeature enabled, or an account with CardFundingAccountFeature enabled.
  • When the transfer purpose is GENERAL, both financial accounts have the PrepaidCardFeature, DebitCardFeature, ProductFundingFeature, or CardFundingAccountFeature enabled.

Output:InitiateTransferBetweenFinancialAccountsPayload

initiateTransferFromFundingFinancialAccountToPaymentCardFinancialAccount​

Add funds to payment card holder FinancialAccount from funding account . Payment Card Holder financial account has PrepaidCardAccountFeature or DebitCardAccountFeature as enabled Origination account is either a Business financial account that has ProductFundingFeature as enabled or account has CardFundingAccountFeature enabled

Output:InitiateTransferFromFundingFinancialAccountToPaymentCardFinancialAccountPayload

initiateTransferFromPaymentCardFinancialAccountToFundingFinancialAccount​

Add funds to funding account from payment card holder FinancialAccount. Payment Card Holder financial account has PrepaidCardAccountFeature or DebitCardAccountFeature as enabled Target account is either a Business financial account that has ProductFundingFeature as enabled or account has CardFundingAccountFeature enabled

Output:InitiateTransferFromPaymentCardFinancialAccountToFundingFinancialAccountPayload

initiateUnifiedFundsTransfer​

Accepts a UnifiedFundsTransferQuote initiating the transfer process. OFAC checks are run on the sender and receiver when a UnifiedNetworkTransfer (or Instant Payment) is initiated.

Output:InitiateUnifiedFundsTransferPayload

initiateUnloadWiredFundsFromFinancialAccount​

Initiate unloading funds from a FinancialAccount via wire.

Output:InitiateUnloadWiredFundsPayload

initiateUSBusinessAuthorizedPersonRequestedIdentityUpdate​

Initiate the request to modify a USBusinessAuthorizedPerson.

Output:InitiateUSBusinessAuthorizedPersonRequestedIdentityUpdatePayload

initiateUSBusinessProfileRequestedIdentityUpdate​

Initiate the request to modify a USBusinessProfile.

Output:InitiateUSBusinessProfileRequestedIdentityUpdatePayload

initiateUSBusinessUltimateBeneficialOwnerRequestedIdentityUpdate​

Initiate the request to modify a USBusinessUltimateBeneficialOwner.

Output:InitiateUSBusinessUltimateBeneficialOwnerRequestedIdentityUpdatePayload

initiateUSPersonAccountHolderRequestedIdentityUpdate​

Initiate the request to modify a USPersonAccountHolder.

Output:InitiateUSPersonAccountHolderRequestedIdentityUpdatePayload

inviteUser​

Invites a User to your Organization.

Output:InviteUserPayload

Input Arguments

issueEmployerFinancialAccountForCardProduct​

Issue an Employer Financial Account against a Product.

Output:IssueEmployerFinancialAccountForCardProductPayload

issueFinancialAccountForApplication​

Issue a new Payment Card against an Account Holder Application.

Output:IssueFinancialAccountForApplicationPayload

issueFinancialAccountForApplicationWithOnDemandFundingSource​

Issue a new Financial Account with an on-demand funding source.

Output:IssueFinancialAccountForApplicationWithOnDemandFundingSourcePayload

issueFundingFinancialAccountForApplication​

Issue a new Funding Financial Account against an Account Holder Application.

Output:IssueFundingFinancialAccountForApplicationPayload

issuePaymentCardForApplication​

Issue a new Payment Card against an Account Holder Application.

Output:IssuePaymentCardForApplicationPayload

issuePaymentCardForApplicationWithOnDemandFundingSource​

Issue a new Payment Card against an Account Holder Application with an on-demand funding source.

Output:IssuePaymentCardForApplicationWithOnDemandFundingSourcePayload

issuePaymentCardForAuthorizedUserApplication​

Issue a new Payment Card against an Authorized User Application.

Output:IssuePaymentCardForApplicationPayload

issuePaymentCardForFinancialAccount​

Issue a new Payment Card against an Account Holder Application.

Output:IssuePaymentCardForFinancialAccountPayload

issuePreprintedPaymentCardFinancialAccountForApplication​

Issues a preprinted payment card financial account for a AccountHolderCardProductApplication.

Output:IssuePreprintedPaymentCardFinancialAccountForApplicationPayload

onboardBusiness​

Onboards a Business for a specific role (third-party agent, merchant, or money movement).

Output:OnboardBusinessPayload

Input Arguments

orderPhysicalPaymentCard​

Order and ship a payment card to an account holder.

Output:OrderPhysicalPaymentCardPayload

Input Arguments

orderPhysicalPaymentCardForGroup​

Order and ship a payment card to an account holder as part of a group order.

Output:OrderPhysicalPaymentCardPayload

orderPhysicalPaymentCardWithValidatedAddressDeprecated​

Order and ship a payment card to an account holder using validated address.

Use `orderPhysicalPaymentCardWithValidatedAddressToken` instead.

Output:OrderPhysicalPaymentCardPayload

orderPhysicalPaymentCardWithValidatedAddressToken​

Order and ship a payment card to an account holder using validated address token.

Output:OrderPhysicalPaymentCardPayload

provisionAccountHolder​

A workflow which provisions an Account Holder

Output:ProvisionAccountHolderPayload

Input Arguments

provisionFlexibleCredential​

Provisions a FlexibleCredential: creates the backing FinancialAccounts, issues one primary and zero or more secondary PaymentCards (with per-card card profile set / BIN selection and per-card expiration), and materializes the FlexibleCredential parent record and its member card records.

Runs synchronously and returns once provisioning completes. Validation and provisioning failures surface through the UserError / AccessDeniedError payload members; a returned ProvisionFlexibleCredentialPayload always represents a completed request.

Output:ProvisionFlexibleCredentialPayload

Input Arguments

publishPricingPlan​

Transitions a PricingPlan from DRAFT to PUBLISHED. Once published, the plan becomes active and its rules can no longer be modified.

Output:PublishPricingPlanPayload

Input Arguments

input: PublishPricingPlanInput!

The input details for publishing the pricing plan.

redeemRewardsForStatementCredit​

Redeem reward points accrued.

Output:RewardPointsTransferPayload

redeemRewardsToFinancialAccount​

Redeem reward points accrued and credit the cash value to a separate destination FinancialAccount. The RewardRedemptionConfiguration used must be of type REDEEM_TO_FINANCIAL_ACCOUNT.

Output:RewardPointsTransferPayload

reevaluateApplication​

For a given application that has already been APPROVED, this creates a new, related application using the latest information available for the account holder and initiates the specified workflow

Output:ReevaluateApplicationPayload

Input Arguments

refundCaptureStep​

Refunds a specific capture step on a payment transaction.

Output:RefundCaptureStepPayload

Input Arguments

refundPaymentTransaction​

Refunds a previously captured payment.

Output:RefundPaymentTransactionPayload

Input Arguments

reissueFlexibleCredentialCards​

Reissues the member PaymentCards of a FlexibleCredential and points the credential at the newly issued cards in one atomic operation. Each card keeps its default FinancialAccount; reissuing the primary card makes its replacement the new primary.

scope selects the cards — ALL_MEMBER_CARDS for every member card, TARGETED for only those listed in targets. The request is all-or-nothing: if any card fails validation, none are reissued.

Output:ReissueFlexibleCredentialCardsPayload

reissuePaymentCard​

Issue a new Payment Card against an existing payment card.

Output:ReissuePaymentCardPayload

Input Arguments

removeCollaborativeAuthorizationEndpoint​

Remove a CollaborativeAuthorizationEndpoint.

Output:RemoveCollaborativeAuthorizationEndpointPayload

removeEmailFromNotificationTarget​

Remove the email for a notification target. This mutation is a noop in the test environment.

Output:RemoveEmailFromNotificationTargetPayload

Input Arguments

input: RemoveEmailFromNotificationTargetInput!

The input to remove the email for a notification target.

removeNotificationTarget​

Deletes a notification target.

Output:RemoveNotificationTargetPayload

Input Arguments

input: RemoveNotificationTargetInput!

The input to delete a notification target.

removeSubscriptionsFromNotificationTarget​

Removes subscriptions from a notification target.

Output:RemoveSubscriptionsFromNotificationTargetPayload

Input Arguments

input: RemoveSubscriptionsFromNotificationTargetInput!

The input to remove subscriptions from a notification target.

removeUser​

Removes a User from your Organization.

Output:RemoveUserPayload

Input Arguments

renameCollaborativeAuthorizationEndpoint​

Rename a CollaborativeAuthorizationEndpoint.

Output:RenameCollaborativeAuthorizationEndpointPayload

renameNotificationTarget​

Updates the name of an existing notification target.

Output:RenameNotificationTargetPayload

Input Arguments

input: RenameNotificationTargetInput!

The input to update the name of an existing notification target.

replayNotificationEvent​

Replays a given Notification Event to all subscribing notification targets.

Output:ReplayNotificationEventPayload

Input Arguments

input: ReplayNotificationEventInput!

The input to replay a Notification Event.

resetPseudoBalance​

Resets the pseudo balance for a FinancialAccount to zero.

Output:ResetPseudoBalancePayload

Input Arguments

reverseInstallmentAgreement​

Reverse an InstallmentAgreement, returning the converted balance to the standard purchase CreditPlan on the FinancialAccount. Reversal is only available until the close of the first FinancialAccountStatement that includes an installment.

Output:ReverseInstallmentAgreementPayload

Input Arguments

reversePaymentTransaction​

Reverses an authorized payment transaction.

The amount is the amount to reverse. When omitted it defaults to the full remaining authorized amount; when supplied it must be greater than zero and no greater than the remaining authorized amount.

Possible UserError codes

  • INVALID_PAYMENT_ID — No payment was found for the given payment ID.
  • REQUIRES_APPROVED_AUTHORIZATION — The payment has no approved authorization to reverse.
  • REVERSAL_AMOUNT_MUST_BE_POSITIVE — The reversal amount must be greater than zero.
  • REVERSAL_AMOUNT_GREATER_REMAINING_AUTHORIZED_AMOUNT — The reversal amount exceeds the remaining authorized amount.
  • PAYMENT_ALREADY_FINAL_CAPTURED_REVERSAL — The payment is already final-captured and cannot be reversed.
  • PARTIAL_REVERSAL_NOT_SUPPORTED — Partial reversal is not supported for this payment; reverse the full remaining amount.
  • PARTIAL_REVERSAL_NOT_ALLOWED_WITH_CASHBACK — Cash-back payments must be reversed in full.

Input validation:

  • NON_EMPTY_INPUT_REQUIRED (field paymentTransactionId) — the payment transaction ID must not be blank.
  • INVALID_INPUT (field paymentTransactionId) — the payment transaction ID is not a valid ID.

Output:ReversePaymentTransactionPayload

Input Arguments

revokeAPIKey​

Revokes an API Key. After revocation, the API Key will be unusable for subsequent requests.

Output:RevokeAPIKeyPayload

Input Arguments

revokeCardAuthenticationContact​

Retire the contact of one kind that is in force on a PaymentCard or a FinancialAccount, and return it as it stood when it was retired.

Any purpose still open is closed at the same time. Authentication falls back to the account holder's identity record from then on. A later bind starts from no contact in force, so it must supply every purpose it expects again.

Output:RevokeCardAuthenticationContactPayload

Input Arguments

input: RevokeCardAuthenticationContactInput!

The contact to retire.

rotateNotificationTargetSigningKey​

Rotate the signing keys for a notification target. Creates a new signing key and sets an expiration date on the old key. The old key will be valid for 24 hours after the new key is created. During that time, signatures for both keys will be sent in the notification payload. There is a maximum of 5 active keys at a time for a target.

Output:RotateNotificationTargetSigningKeyPayload

Input Arguments

input: RotateNotificationTargetSigningKeyInput!

The ID of the notification target to rotate the signing key for.

setEmailForNotificationTarget​

Sets the email for a notification target. This data is only stored in the live environment. Deactivation emails are not sent in the test environment.

Output:SetEmailForNotificationTargetPayload

Input Arguments

input: SetEmailForNotificationTargetInput!

The input to set the email for a notification target.

setPinForPaymentCard​

Set a pin on a payment card.

Output:SetPinForPaymentCardPayload

Input Arguments

setPseudoLimit​

Sets the pseudo balance limit amount for a FinancialAccount.

Output:SetPseudoLimitPayload

Input Arguments

simulateAchTransferProcessing​

Simulates processing of an OriginatedAchTransfer or NonOriginatedAchTransfer. The status is updated to PROCESSED.

Note: This feature is only available in the TEST environment.

Output:SimulateAchTransferProcessingPayload

simulateAchTransferReturn​

Simulates return of an OriginatedAchTransfer or NonOriginatedAchTransfer. The status will be updated to RETURNED.

Note: This feature is only available in the TEST environment.

Output:SimulateAchTransferReturnPayload

Input Arguments

simulateAdjustment​

Simulate behaviors around a network adjustment in the Test environment.

This operation mirrors Live behavior and allows you to test various scenarios before going live.

Output:SimulateAdjustmentPayload

Input Arguments

simulateApplicationDocumentReview​

Simulate updating the review status on a previously created AccountHolderApplicationDocument in the Test environment.

This operation allows you to test various application lifecycle scenarios before going live.

Output:SimulateApplicationDocumentReviewPayload

simulateApplicationStatusChange​

Simulate updating the application status on a previously created AccountHolderCardProductApplication in the Test environment.

This operation allows you to test various application lifecycle scenarios before going live.

Output:SimulateApplicationUpdatePayload

simulateApplicationVerificationStatusChange​

Simulate updating the verification status for existing AccountHolder on a previously created AccountHolderCardProductApplication in the Test environment.

This operation allows you to test various application lifecycle scenarios before going live.

Output:SimulateApplicationUpdatePayload

simulateAuthorization​

Simulate behaviors around authorizations in the Test environment. This operation mirrors Live behavior and allows you to test various scenarios before going live.

Output:SimulateAuthorizationPayload

Input Arguments

simulateBackwardShiftAndAgeCurrentFinancialAccountStatementPeriod​

Shift the statement end period of the current statement for a Financial Account n periods backward, and age the account.

The FinancialAccount must have an OUTSTANDING_BALANCE_PAYABLE > 0, and it cannot have any closed billing statements more recent than the numberOfCyclesToShiftCurrentStatementBackward input.

Note: This feature is only available in the TEST environment.

Output:SimulateFinancialAccountAgingPayload

simulateCardDigitalWalletTokenActivated​

Simulate the card digital wallet token activated flow.

Note: This feature is only available in the TEST environment.

Output:SimulateCardDigitalWalletTokenPayload

simulateCardDigitalWalletTokenActivation​

Simulate the card digital wallet token activation flow.

Note: This feature is only available in the TEST environment.

Output:SimulateCardDigitalWalletTokenPayload

simulateCheckbookUserVerification​

Simulates a checkbook user KYC verification. Signals the onboarding workflow to proceed with wallet creation. This will only work in test environments.

Output:SimulateCheckbookUserVerificationPayload

simulateCheckPaymentEvent​

Simulates a CheckPaymentEvent for an initiated physical check payment. This will only work in the prod-test environment.

Output:SimulateCheckPaymentEventChangePayload

Input Arguments

simulateClearing​

Simulate behaviors around clearing authorizations in the Test environment.

This operation mirrors Live behavior and allows you to test various scenarios before going live.

Output:SimulateClearingPayload

Input Arguments

simulateCloseFinancialAccount​

Simulates moving a FinancialAccount into CLOSED status. The specified FinancialAccount must be in PENDING_CLOSURE status.

Note: This feature is only available in the TEST environment.

Output:SimulateCloseFinancialAccountPayload

simulateCreateAndActivateFeeSchedule​

Simulated create new fee schedule in the Highnote test environment.

Note: This feature is only available in the TEST environment.

Output:SimulateCreateAndActivateFeeSchedulePayload

simulateCreateApplicationDocumentsUploadSessions​

Simulate creating the application documents upload sessions.

Output:SimulateApplicationManualReviewPayload

simulateCreateMerchantMatchConfig​

Simulates creating a merchant MATCH screening configuration for an acquiring CardProduct, enabling MATCH screening to trigger during merchant onboarding.

Note: This feature is only available in the TEST environment.

Output:SimulateCreateMerchantMatchConfigPayload

simulateDeposit​

Add funds to an Organization's account in the Highnote test environment.

Output:SimulateDepositPayload

Input Arguments

simulateDigitalWalletTokenAuthorization​

Simulate an authorization using a digital wallet token in the Test environment.

This operation mirrors Live behavior and allows you to test various scenarios before going live.

Note: This feature is only available in the TEST environment.

Output:SimulateAuthorizationPayload

simulateDigitalWalletTokenFlexibleCredentialAuthorization​

Simulate a Visa Flexible Credential authorization using a digital wallet token in the Test environment.

This operation simulates an authorization using a digital wallet token whose underlying primary card is part of a flexible credential, allowing the backend to select an appropriate secondary credential based on transaction context.

Note: This feature is only available in the TEST environment.

Output:SimulateAuthorizationPayload

simulateDigitalWalletTokenMastercardFleetAuthorization​

Simulate the authorization of a Mastercard Fleet transaction using a digital wallet token in the Test environment. This allows for partial authorizations.

This operation mirrors Live behavior and allows you to test various scenarios before going live.

Note: This feature is only available in the TEST environment.

Output:SimulateAuthorizationPayload

simulateDigitalWalletTokenSingleStepAuthAndClear​

Simulate a single step authorization and clear using a digital wallet token in the Test environment.

This operation mirrors Live behavior and allows you to test various scenarios before going live.

Note: This feature is only available in the TEST environment.

Output:SimulateAuthAndClearPayload

simulateDigitalWalletTokenVisaFleetAuthorization​

Simulate the authorization of a Visa Fleet transaction using a digital wallet token in the Test environment. This allows for partial authorizations.

This operation mirrors Live behavior and allows you to test various scenarios before going live.

Note: This feature is only available in the TEST environment.

Output:SimulateAuthorizationPayload

simulateExternallyInitiatedACHTransfer​

Simulate initiating a new ExternallyInitiatedACHTransfer.

This is only used for testing purposes.

Output:ExternallyInitiatedACHTransferPayload

simulateFinalizeProvisionalCreditForCardTransactionDispute​

Simulate finalizing the provisional credit for the card transaction dispute.

Output:PaymentCardTransactionDisputePayload

simulateFlexibleCredentialAuthorization​

Simulate a Visa Flexible Credential authorization in the Test environment.

This operation simulates an authorization using a primary card of a flexible credential, allowing the backend to select an appropriate secondary credential based on transaction context.

Note: This feature is only available in the TEST environment.

Output:SimulateAuthorizationPayload

simulateInitiateCardTransactionChargeback​

Simulate initiating the chargeback for the card transaction dispute.

Output:SimulatePaymentCardTransactionDisputePayload

simulateInitiateCardTransactionDispute​

Simulate initiating the dispute for the card transaction.

Output:SimulatePaymentCardTransactionDisputePayload

simulateInitiateFinancialAccountClosure​

Simulates moving a FinancialAccount into PENDING_CLOSURE status. The PENDING_CLOSURE account attribute will also be applied.

Note: This feature is only available in the TEST environment.

Output:SimulateInitiateFinancialAccountClosurePayload

simulateIssueCreditForCardTransactionDispute​

Simulate issuing the Credit for a Dispute that has been decided in favor of the Account Holder for cases where the Dispute was not sent as a Chargeback to the Network due to not meeting the DisputeChargebackCardProductFeature.chargebackMinimumThreshold.

Output:SimulatePaymentCardTransactionDisputePayload

simulateIssueProvisionalCreditForCardTransactionDispute​

Simulate issuing provisional credit for the card transaction dispute when the disputed amount meets the DisputeChargebackCardProductFeature.chargebackMinimumThreshold.

Output:SimulatePaymentCardTransactionDisputePayload

simulateIssuerAcceptsFullCardPaymentDispute​

Simulates the issuer accepting the CardPaymentDispute in full.

Output:SimulateCardPaymentDisputePayload

simulateIssuerAcceptsPartialCardPaymentDispute​

Simulates the issuer accepting a CardPaymentDispute in part, with an explicit conceded (settled) amount. On collaboration disputes the conceded amount is settled and the dispute closes as won in part; on allocation disputes the partial acceptance is not settled automatically and the dispute stays open for manual review.

Output:SimulateCardPaymentDisputePayload

simulateIssuerFilesPreArbitrationCardPaymentDispute​

Simulates the issuer declining the merchant's representment by filing an issuer-initiated pre-arbitration, opening the acquirer's pre-arbitration-response window. Collaboration CardPaymentDisputes only.

Output:SimulateCardPaymentDisputePayload

simulateIssuerFilesPreArbitrationResponseCardPaymentDispute​

Simulates the issuer declining the acquirer's pre-arbitration by filing a pre-arbitration response, opening the acquirer's arbitration window. Allocation CardPaymentDisputes only.

Output:SimulateCardPaymentDisputePayload

simulateIssuerInitiatesCardPaymentDispute​

Simulates the issuer initiating a dispute against a captured payment transaction, creating a new CardPaymentDispute. Available in test environments only.

Output:SimulateCardPaymentDisputePayload

simulateMastercardFleetAuthorization​

Simulate the authorization of a Mastercard Fleet transaction in the Test environment. This allows for partial authorizations.

This operation mirrors Live behavior and allows you to test various scenarios before going live.

Note: This feature is only available in the TEST environment.

Output:SimulateAuthorizationPayload

simulateMastercardFleetAuthorizationAdvice​

Simulate an authorization advice event for a Mastercard Fleet transaction in the Test environment.

This creates a ReversalEvent for the difference between the authorized amount and the provided advice amount.

This operation mirrors Live behavior and allows you to test various scenarios before going live.

Note: This feature is only available in the TEST environment.

Output:SimulateAuthorizationAdvicePayload

simulateMastercardFleetClearing​

Simulate the ClearingEvent for a Mastercard Fleet transaction in the Test environment.

This operation mirrors Live behavior and allows you to test various scenarios before going live.

Note: This feature is only available in the TEST environment.

Output:SimulateClearingPayload

simulateMastercardFleetEnhancedData​

Simulate the MastercardFleetEnhancedData for a Mastercard Fleet transaction in the Test environment.

Allows for the input of enhanced transaction data pertaining to a Mastercard Fleet transaction to mimic what would be received in a Live transaction.

This operation mirrors Live behavior and allows you to test various scenarios before going live.

Note: This feature is only available in the TEST environment.

Output:SimulateEnhancedDataPayload

simulateMerchantMatchInReview​

Simulates placing an acquiring application's merchant screening into the IN_REVIEW state, as if the MATCH screening workflow had flagged it.

Note: This feature is only available in the TEST environment.

Output:ProductApplicationPayload

simulateNonOriginatedAchTransfer​

Simulate receiving a new NonOriginatedACHTransfer.

Note: This feature is only available in the TEST environment.

Output:SimulateNonOriginatedAchTransferPayload

simulateNonOriginatedRtpTransfer​

Simulate the receipt of an inbound non-originated RTP credit.

Note: This feature is only available in the TEST environment.

Output:SimulateNonOriginatedRtpTransferPayload

simulatePhysicalCardGroupOrderApproval​

Simulate printer approval of the order. This can only be called while the order is in the SENT_TO_PRINTER state.

Note: This feature is only available in the TEST environment.

Output:SimulatePhysicalCardGroupOrderPayload

simulatePhysicalCardGroupOrderSendToPrinter​

Simulate sending the order to the printer for fulfillment. This can only be called while the order is in the NEW state.

Note: This feature is only available in the TEST environment.

Output:SimulatePhysicalCardGroupOrderPayload

simulatePhysicalCardGroupOrderShipmentFailed​

Simulate a failed shipment by the printer. This can only be called while the order is in the APPROVED state.

Note: This feature is only available in the TEST environment.

Output:SimulatePhysicalCardGroupOrderPayload

simulatePhysicalCardGroupOrderShipped​

Simulate a successful shipment by the printer. This can only be called while the order is in the APPROVED state.

Note: This feature is only available in the TEST environment.

Output:SimulatePhysicalCardGroupOrderPayload

simulatePhysicalPaymentCardOrderApproval​

Simulate printer approval of the order. This can only be called while the order is in the SENT_TO_PRINTER state.

Note: This feature is only available in the TEST environment.

Output:SimulatePhysicalPaymentCardPayload

simulatePhysicalPaymentCardOrderSendToPrinter​

Simulate sending the order to the printer for fulfillment. This can only be called while the order is in the NEW state.

Note: This feature is only available in the TEST environment.

Output:SimulatePhysicalPaymentCardPayload

simulatePhysicalPaymentCardOrderShipmentFailed​

Simulate a failed shipment by the printer. This can only be called while the order is in the APPROVED state.

Note: This feature is only available in the TEST environment.

Output:SimulatePhysicalPaymentCardPayload

simulatePhysicalPaymentCardOrderShipped​

Simulate a successful shipment by the printer. This can only be called while the order is in the APPROVED state.

Note: This feature is only available in the TEST environment.

Output:SimulatePhysicalPaymentCardPayload

simulatePricingPlan​

Simulates pricing calculations for a PricingPlan using provided context data. The plan can be in any status (PUBLISHED, DRAFT, or ARCHIVED). Accepts context data as a base64-encoded CSV and returns simulation results as a base64-encoded CSV.

Output:SimulatePricingPlanPayload

Input Arguments

input: SimulatePricingPlanInput!

The input details for the pricing simulation.

simulateProcessedIntegratorInitiatedStatusChange​

Change the status of an IntegratorInitiatedACHTransfer from PROCESSING to PROCESSED.

Note: This feature is only available in the TEST environment.

Output:SimulateProcessedIntegratorInitiatedStatusChangePayload

simulateProcessingExternallyInitiatedStatusChange​

Change the status of an ExternallyInitiatedACHTransfer from PENDING to PROCESSING.

Note: This feature is only available in the TEST environment.

Output:ExternallyInitiatedACHTransferPayload

simulateProcessingIntegratorInitiatedStatusChange​

Change the status of an IntegratorInitiatedACHTransfer from INITIATED to PROCESSING.

Note: This feature is only available in the TEST environment.

Output:SimulateProcessingIntegratorInitiatedStatusChangePayload

simulateRefund​

Simulate behaviors around reversing authorizations in the Test environment.

This operation mirrors Live behavior and allows you to test various scenarios before going live.

Note: In Test, the RefundResponseCode will always be APPROVED, however, more response codes may be added in the future.

Output:SimulateRefundPayload

Input Arguments

simulateResolvePaymentCardTransactionChargebackDeprecated​

Simulate resolving the payment card transaction chargeback for the dispute. If received amount is 0, the chargeback is resolved as a loss.

Use simulateFinalizeProvisionalCreditForCardTransactionDispute instead.

Output:SimulatePaymentCardTransactionDisputePayload

simulateReturnedIntegratorInitiatedStatusChange​

Change the status of an IntegratorInitiatedACHTransfer from PROCESSING to RETURNED.

Note: This feature is only available in the TEST environment.

Output:SimulateReturnedIntegratorInitiatedStatusChangePayload

simulateReversal​

Simulate behaviors around reversing authorizations in the Test environment.

This operation mirrors Live behavior and allows you to test various scenarios before going live.

Note: In Test, the ReversalResponseCode will always be APPROVED, however, more response codes may be added in the future.

Output:SimulateReversalPayload

Input Arguments

simulateRolloverCurrentFinancialAccountStatementPeriod​

Rollover the current/next statements. This will simultaneously close the current open statement and open the next statement. If the current open statement's end period is in the future, this will fail. Use simulateShiftCurrentFinancialAccountStatementPeriod mutation to move the end period to now.

Note: This feature is only available in the TEST environment.

Output:SimulateFinancialAccountStatementPayload

simulateShiftCurrentFinancialAccountStatementPeriod​

Shift the statement end period of the current statement for an account to now.

Note: This feature is only available in the TEST environment.

Output:SimulateFinancialAccountStatementPayload

simulateSingleStepAuthAndClear​

Simulate behaviors around a single step authorization and clear in the Test environment. This operation mirrors Live behavior and allows you to test various scenarios before going live.

Output:SimulateAuthAndClearPayload

simulateUpdateCardTransactionDispute​

Simulate updating the dispute for the card transaction.

Output:SimulatePaymentCardTransactionDisputePayload

simulateUpdatePaymentCardTransactionChargeback​

Simulate updating the payment card transaction chargeback for the dispute. If received amount is 0, the chargeback is resolved as a loss.

Output:SimulatePaymentCardTransactionDisputePayload

simulateVisaFleetAuthorization​

Simulate the authorization of a Visa Fleet transaction in the Test environment. This allows for partial authorizations.

This operation mirrors Live behavior and allows you to test various scenarios before going live.

Note: This feature is only available in the TEST environment.

Output:SimulateAuthorizationPayload

simulateVisaFleetAuthorizationAdvice​

Simulate an authorization advice event for a Visa Fleet transaction in the Test environment.

This creates a ReversalEvent for the difference between the authorized amount and the provided advice amount.

This operation mirrors Live behavior and allows you to test various scenarios before going live.

Note: This feature is only available in the TEST environment.

Output:SimulateAuthorizationAdvicePayload

simulateVisaFleetClearing​

Simulate the ClearingEvent for a Visa Fleet transaction in the Test environment.

Also allows for input of simulated VisaFleetL2TransactionData to mimic what would be received in a Live clearing event.

This operation mirrors Live behavior and allows you to test various scenarios before going live.

Note: This feature is only available in the TEST environment.

Output:SimulateClearingPayload

Input Arguments

simulateVisaFleetL3EnhancedData​

Simulate the VisaFleetL3EnhancedData for a Visa Fleet transaction in the Test environment.

Allows for the input of Level 3 transaction data pertaining to a Visa Fleet transaction to mimic what would be received in a Live transaction.

This operation mirrors Live behavior and allows you to test various scenarios before going live.

Note: This feature is only available in the TEST environment.

Output:SimulateVisaFleetL3EnhancedDataPayload

startDocumentUploadSession​

Initiates a session to allow multiple files to be uploaded.

Output:StartDocumentUploadSessionPayload

Input Arguments

submitCardPaymentDisputeEvidence​

Finalizes the evidence uploaded to the active stage of a CardPaymentDispute via the session opened by initiateCardPaymentDisputeEvidenceUpload. Closes the upload session — no further evidence can be added to the stage afterward.

Output:SubmitCardPaymentDisputeEvidencePayload

suspendCardDigitalWalletToken​

Temporarily suspend a card digital wallet token.

Output:SuspendCardDigitalWalletTokenPayload

suspendFinancialAccount​

Suspends a FinancialAccount.

Output:FinancialAccountPayload

Input Arguments

suspendPaymentCard​

Suspend a Payment Card and decline all authorizations until the suspension is lifted.

Output:SuspendPaymentCardPayload

Input Arguments

terminateCardDigitalWalletToken​

Terminate a card digital wallet token.

Output:TerminateCardDigitalWalletTokenPayload

tokenizeCardPaymentMethod​

Creates a single use payment method from a card.

Output:TokenizeCardPaymentMethodPayload

Input Arguments

tokenizeUSBusinessAccountHolder​

Tokenizes data for a new USBusinessAccountHolder.

Output:TokenizeUSBusinessAccountHolderPayload

tokenizeUSPersonAccountHolder​

Tokenizes data for a new USPersonAccountHolder.

Output:TokenizeUSPersonAccountHolderPayload

Input Arguments

tokenizeUSPersonAuthorizedUser​

Tokenizes data for a new USPersonAuthorizedUser.

Output:TokenizeUSPersonAuthorizedUserPayload

transferFunds​

Execute a funds transfer directly.

Output:TransferFundsPayload

Input Arguments

unsuspendCardDigitalWalletToken​

Reactivate a suspended card digital wallet token.

Output:UnsuspendCardDigitalWalletTokenPayload

unsuspendFinancialAccount​

Unsuspends a FinancialAccount.

Output:FinancialAccountPayload

Input Arguments

updateAccountHolderCardProductApplicationOffers​

Update non-terminal AccountHolderCardProductApplicationOffer on an AccountHolderCardProductApplication.

Output:AccountHolderCardProductApplicationOffersPayload

updateAccountSpendRule​

Updates an existing spend rule that specifies which accounts are either allowed or blocked.

Output:UpdateAccountSpendRulePayload

Input Arguments

updateAccountTransactionCountSpendRule​

Updates a AccountTransactionCountSpendRule that limits the number of transactions on an account.

Output:UpdateAccountTransactionCountSpendRulePayload

updateAmountLimitSpendRule​

Updates an existing spend rule that limits the amount of authorizations.

Output:UpdateAmountLimitSpendRulePayload

Input Arguments

updateCardDataInputCapabilitySpendRule​

Updates a CardDataInputCapabilitySpendRule that allows or blocks a CardDataInputCapability.

Output:UpdateCardDataInputCapabilitySpendRulePayload

updateCardProductName​

Changes the name of a Card Product.

Output:UpdateCardProductNamePayload

Input Arguments

updateCardTransactionProcessingTypeConditionSpendRule​

Updates a CardTransactionProcessingTypeConditionSpendRule that allows or blocks a CardTransactionProcessingType.

Output:UpdateCardTransactionProcessingTypeConditionSpendRulePayload

updateConditionalRuleSetSpendRule​

Updates a ConditionalRuleSetSpendRule that combines the results of multiple spend rules.

Output:UpdateConditionalRuleSetSpendRulePayload

updateCountLimitSpendRule​

Updates an existing spend rule that limits the number of allowed transactions.

Output:UpdateCountLimitSpendRulePayload

Input Arguments

updateCreditLimitPercentageSpendRule​

Updates a CreditLimitPercentageSpendRule that limits the amount a transaction can be authorized for to a percentage of the credit limit.

Output:UpdateCreditLimitPercentageSpendRulePayload

updateCustomFields​

Updates CustomFields for an object.

Output:CustomFieldsPayload

Input Arguments

updateCVVSpendRule​

Updates an existing spend rule that specifies if the result of a CVV check should be approved or declined.

Output:UpdateCVVSpendRulePayload

Input Arguments

updateDaysWithinAccountCreateDateSpendRule​

Updates a DaysWithinAccountCreateDateSpendRule that allows for spending up to a specified number of days since the create date of the card's FinancialAccount.

Output:UpdateDaysWithinAccountCreateDateSpendRulePayload

updateDaysWithinCardCreateDateSpendRule​

Updates a DaysWithinCardCreateDateSpendRule that allows for spending up to a specified number of days since the create date of the PaymentCard.

Output:UpdateDaysWithinCardCreateDateSpendRulePayload

updateDepositAmountLimitSpendRule​

Updates a DepositAmountLimitSpendRule that limits the amount of authorizations.

Output:UpdateDepositAmountLimitSpendRulePayload

updateDepositCountLimitSpendRule​

Updates a DepositCountLimitSpendRule that limits the number of authorizations.

Output:UpdateDepositCountLimitSpendRulePayload

updateDepositProcessingNetworkSpendRule​

Updates a DepositProcessingNetworkSpendRule which allows or blocks an ATM processing network.

Output:UpdateDepositProcessingNetworkSpendRulePayload

updateFinancialAccountBillingCycleConfiguration​

Update the billing cycle configuration for a FinancialAccount. Currently, this enables you to update the day of the month when payment is due for a FinancialAccount. The change only applies to future billing cycles, not the current open cycle or any closed cycles.

Output:UpdateFinancialAccountBillingCycleConfigurationPayload

updateFinancialAccountName​

Changes the name of a Financial Account.

Output:UpdateFinancialAccountNamePayload

Input Arguments

updateMastercardFraudScoreSpendRule​

Updates a MastercardFraudScoreSpendRule that limits the acceptable Mastercard Fraud Score for transactions.

Output:UpdateMastercardFraudScoreSpendRulePayload

updateMaximumAmountVarianceOnCreditLimitSpendRule​

Updates a MaximumAmountVarianceOnCreditLimitSpendRule that allows transactions up to a specified Amount over the credit limit.

Output:UpdateMaximumAmountVarianceOnCreditLimitSpendRulePayload

updateMaximumAmountVarianceOnPseudoBalanceSpendRule​

Updates a MaximumAmountVarianceOnPseudoBalanceSpendRule that allows for spending up to a specified Amount above the account's original balance.

Output:UpdateMaximumAmountVarianceOnPseudoBalanceSpendRulePayload

updateMaximumPercentVarianceOnCreditLimitSpendRule​

Updates a MaximumPercentVarianceOnCreditLimitSpendRule that allows transactions up to a specified percentage over the credit limit.

Output:UpdateMaximumPercentVarianceOnCreditLimitSpendRulePayload

updateMaximumPercentVarianceOnPseudoBalanceSpendRule​

Updates a MaximumPercentVarianceOnPseudoBalanceSpendRule that allows for spending up to a specified percentage over the account's original balance.

Output:UpdateMaximumPercentVarianceOnPseudoBalanceSpendRulePayload

updateMerchantCategorySpendRule​

Updates an existing spend rule that specifies the merchant categories that are either allowed or blocked during authorizations.

Output:UpdateMerchantCategorySpendRulePayload

updateMerchantCountrySpendRule​

Updates an existing spend rule that specifies the merchant countries that are either allowed or blocked during authorizations.

Output:UpdateMerchantCountrySpendRulePayload

updateMerchantIdentifierSpendRule​

Updates an existing spend rule that specifies which merchant identifiers (MIDs) are either allowed or blocked.

Output:UpdateMerchantIdentifierSpendRulePayload

updateMinimumAmountLimitSpendRule​

Updates a MinimumAmountLimitSpendRule that only allows transactions for a specified amount.

Output:UpdateMinimumAmountLimitSpendRulePayload

updateOrganizationProfileDisplayName​

Update the display name of an organization.

Output:UpdateOrganizationProfileDisplayNamePayload

updatePanEntryModeSpendRule​

Updates a PanEntryModeSpendRule that allows or blocks a PanEntryMode.

Output:UpdatePanEntryModeSpendRulePayload

Input Arguments

updatePointOfServiceCategorySpendRule​

Updates an existing spend rule that specifies which Point of Service (POS) categories are either allowed or blocked.

Output:UpdatePointOfServiceCategorySpendRulePayload

updatePostalCodeVerificationSpendRule​

Updates an existing spend rule that specifies which address verification postal codes categories are either allowed or blocked.

Output:UpdatePostalCodeVerificationSpendRulePayload

updatePseudoBalance​

Updates the pseudo balance amount for a FinancialAccount. The amount can be increased or decreased.

Output:UpdatePseudoBalancePayload

Input Arguments

updatePseudoLimit​

Updates the pseudo limit amount for a FinancialAccount. The amount can be increased or decreased.

Output:UpdatePseudoLimitPayload

Input Arguments

updateRewardRedemptionConfigurationAttachment​

Update a RewardRedemptionConfigurationAttachment. Note: only the effective through date is modifiable.

Output:UpdateRewardRedemptionConfigurationAttachmentPayload

updateRewardRuleAttachment​

Update a RewardRuleAttachment. Note: only the effective through date is modifiable.

Output:UpdateRewardRuleAttachmentPayload

Input Arguments

updateStreetAddressSpendRule​

Updates an existing spend rule that specifies if the result of street address verification should be approved or declined.

Note Street address verifications only verify a street number. Use createPostalCodeVerificationSpendRule to change how postal codes are verified.

Output:UpdateStreetAddressSpendRulePayload

updateUSAssociatedPersonAccountHolderEmail​

Update email for existing USAssociatedPersonAccountHolder.

Output:UpdateUSAssociatedPersonAccountHolderPayload

updateUSAssociatedPersonAccountHolderHomeAddress​

Update address for existing USAssociatedPersonAccountHolder.

Output:UpdateUSAssociatedPersonAccountHolderPayload

updateUSAssociatedPersonAccountHolderPhone​

Update phone for existing USAssociatedPersonAccountHolder.

Output:UpdateUSAssociatedPersonAccountHolderPayload

updateUSBusinessAccountHolderBillingAddress​

Update address for existing USBusinessAccountHolder.

Output:UpdateUSBusinessAccountHolderPayload

updateUSBusinessAccountHolderCreditRiskAttribute​

Update credit risk attribute for existing USBusinessAccountHolder.

Output:UpdateUSBusinessAccountHolderPayload

updateUSBusinessAccountHolderPhone​

Update phone for existing USBusinessAccountHolder.

Output:UpdateUSBusinessAccountHolderPayload

updateUSBusinessAccountHolderWebsite​

Update website for existing USBusinessAccountHolder.

Output:UpdateUSBusinessAccountHolderPayload

updateUser​

Updates an existing Users data.

Output:UpdateUserPayload

Input Arguments

updateUserDefinedField​

Updates a UserDefinedField.

Output:UserDefinedFieldPayload

Input Arguments

updateUserDefinedFieldDefinition​

Updates a UserDefinedFieldDefinition.

Output:UserDefinedFieldDefinitionPayload

updateUSPersonAccountHolderBillingAddress​

Update billing address for existing USPersonAccountHolder.

Output:UpdateUSPersonAccountHolderPayload

updateUSPersonAccountHolderCreditRiskAttribute​

Update credit risk attribute for an existing USPersonAccountHolder.

Output:UpdateUSPersonAccountHolderPayload

updateUSPersonAccountHolderEmail​

Update email for existing USPersonAccountHolder.

Output:UpdateUSPersonAccountHolderPayload

updateUSPersonAccountHolderPhone​

Update phone for existing USPersonAccountHolder.

Output:UpdateUSPersonAccountHolderPayload

updateUSPersonAuthorizedUserBillingAddress​

Update address for existing USPersonAuthorizedUser.

Output:UpdateUSPersonAuthorizedUserPayload

updateUSPersonAuthorizedUserEmail​

Update email for existing USPersonAuthorizedUser.

Output:UpdateUSPersonAuthorizedUserPayload

updateUSPersonAuthorizedUserPhone​

Update phone for existing USPersonAuthorizedUser.

Output:UpdateUSPersonAuthorizedUserPayload

updateVelocityRule​

Update an existing VelocityRule

Output:UpdateVelocityRulePayload

Input Arguments

updateVisaRiskScoreSpendRule​

Updates a VisaRiskScoreSpendRule that limits the acceptable Visa Risk Score for transactions.

Output:UpdateVisaRiskScoreSpendRulePayload

validateAddress​

Validate provided address.

Output:ValidateAddressPayload

Input Arguments

verifyNetworkToken​

Verifies that the NetworkTokenInput is a valid NetworkToken, and able to be used during authorization.

Output:VerifyNetworkTokenPayload

Input Arguments

verifyPaymentCard​

Verifies that the PaymentCardInput is a valid PaymentCard, and able to be used during authorization.

Output:VerifyPaymentCardPayload

Input Arguments

verifyPaymentMethodToken​

Verifies that the PaymentMethodTokenInput is a valid payment method token, and can be used for authorization.

Output:VerifyPaymentMethodTokenPayload

Input Arguments

waiveFeeTransfer​

Waive fee of a fee transfer event.

This will waive fee of already charged fee transfer event.

Output:FeeTransferEventPayload

Input Arguments

waiveInterestAmountForClosedStatement​

Waive full interest for an InterestAssessmentEvent associated with a closed FinancialAccountStatement.

Output:WaiveInterestAmountForClosedStatementPayload