Use Adyen's stored-value (gift card) payment method API to check balance and perform split tender with a credit card for the remainder

domain: docs.adyen.com/payment-methods/gift-cards · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Issue a balance check request to Adyen using the paymentMethods response to confirm the gift card payment method is enabled on your merchant account
  2. Perform an initial payment request with the gift card payment method details and the full order amount
  3. If the response contains resultCode PARTIAL_AUTHORISED with an amountValue in the additionalData, the gift card covered only part of the total
  4. Record the pspReference from the partial approval and the remaining open amount
  5. 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
  6. Only fulfill the order after both payments have been successfully authorized and settled

Known gotchas

Related routes

Implement Adyen split payments via the splits array on a payment request to allocate funds to balance accounts and collect a commission
docs.adyen.com · 6 steps · unrated
Split a payment across Balance Accounts using Adyen Balance Platform split payments
docs.adyen.com · 6 steps · unrated
Store a card with Adyen and charge it for recurring payments using the shopperReference model
adyen.com · 6 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans