Issue a balance check request to Adyen using the paymentMethods response to confirm the gift card payment method is enabled on your merchant account
Perform an initial payment request with the gift card payment method details and the full order amount
If the response contains resultCode PARTIAL_AUTHORISED with an amountValue in the additionalData, the gift card covered only part of the total
Record the pspReference from the partial approval and the remaining open amount
Submit a second payment request for the remaining amount using the cardholder's credit card, including the original gift card pspReference in a split tender reference field
Only fulfill the order after both payments have been successfully authorized and settled
Known gotchas
Split tender across gift card and card requires your Adyen account to have split payments configured; contact Adyen to enable this before going live
If the second payment (credit card) fails, you must void the gift card partial authorization promptly to avoid holding the gift card balance in limbo
Gift card balance inquiries are not free in all configurations; excessive balance checks on non-purchase flows may incur API fees
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp