Adyen Go API Library v21.2.3

Contents

• What's Changed (#whats-changed)
• New Features 💎 (#new-features-)
• Fixes ⛑️ (#fixes-️)
• Contributor Notes 🔧 (#contributor-notes-)
• Other Changes 🖇️ (#other-changes-️)
• PRs 📋️ (#prs-️)
• Contributors (#contributors)

What's Changed

This release adds networkVariant to issued card data in Transaction and Transfer webhooks, and Transfer webhooks gain newly accepted status, type, and namespace values (reversalReceived, fxSell, fxBuy, usAchCorrectionReasonCode). The client no longer prints Custom http.Client is provided to stdout when a custom HTTP client is provided through common.Config.HTTPClient. The README HTTP client configuration guidance is substantially expanded, and the CI workflows are hardened with explicit permissions, a job-local Go module cache, and updated actions/setup-go and SonarQube scan actions.

New Features 💎

Transaction Webhooks

• Add NetworkVariant to transactionwebhook.IssuedCard (JSON: networkVariant), exposing the card variant associated with the payment network used to route or process a transaction. For single-network cards it matches brandVariant; for US dual-network cards routed over an alternate network it reflects the specific tier or sub-type under that network. Supported values: maestro_us, mastercard, and visa. (#602)

Transfer Webhooks

• Add NetworkVariant to transferwebhook.IssuedCard (JSON: networkVariant), with the same semantics and supported values as the Transaction Webhooks addition: maestro_us, mastercard, and visa. (#601)
• Extend Transfer Webhooks models with newly accepted values (#601):
• reversalReceived transfer status on transferwebhook.Modification, transferwebhook.TransferData, and transferwebhook.TransferEvent
• fxSell and fxBuy transfer types on transferwebhook.TransferData
• usAchCorrectionReasonCode reason-code namespace on transferwebhook.NetworkReason

Fixes ⛑️

• Remove the fmt.Println("Custom http.Client is provided") statement from adyen.NewClient, so the library no longer writes directly to stdout when a custom HTTP client is provided through common.Config.HTTPClient. (#470)

Contributor Notes 🔧

• Update SonarSource/sonarqube-scan-action from v6 to v8 in the SonarCloud workflow. (#568)
• Update actions/setup-go from v6 to v7 in the Go workflow and in the shared format action. ((#588)
• Harden GitHub Actions permissions: the Go workflow no longer uses sudo to clear the module cache, and the label-new-issues and stale workflows declare explicit minimum token permissions. (#595)
• Use a job-local Go module cache (GOMODCACHE under RUNNER_TEMP) in the Go workflow, avoiding permission failures while cleaning the runner-shared module cache. (#597)

Other Changes 🖇️

• Expand the README HTTP client configuration guidance, covering safe transport customization by cloning http.DefaultTransport, connection pooling, timeout behavior, proxy configuration, and idempotency and retry considerations. The README example tests were updated to match. (#596)
• Update the managementwebhook.MidServiceNotificationData.Type documentation to note that for the cartebancaire payment method variant, method-specific details are returned in the cartesBancaires object. (#600)
• Document tracing as a possible value of transferwebhook.TransferEvent.Type. (#604)

PRs 📋️

• fix(api): remove noisy print when custom http client is provided by @rmargar (https://github.com/rmargar) in (#470)
• Update SonarSource/sonarqube-scan-action action to v8 by @renovate[bot] (https://github.com/apps/renovate) in (#568)
• Update actions/setup-go action to v7 by @renovate[bot] (https://github.com/apps/renovate) in (#588)
• fix(ci): harden GitHub Actions permissions by @gcatanese (https://github.com/gcatanese) in (#595)
• Docs: improve HTTP client configuration guidance by @gcatanese (https://github.com/gcatanese) in (#596)
• fix(ci): use job-local Go module cache by @gcatanese (https://github.com/gcatanese) in (#597)
• [managementwebhooks] Code generation: update services and models by @AdyenAutomationBot (https://github.com/AdyenAutomationBot) in (#600)
• [transferwebhooks] Code generation: update services and models by @AdyenAutomationBot (https://github.com/AdyenAutomationBot) in (#601)
• [transactionwebhooks] Code generation: update services and models by @AdyenAutomationBot (https://github.com/AdyenAutomationBot) in (#602)
• [transferwebhooks] Code generation: update services and models by @AdyenAutomationBot (https://github.com/AdyenAutomationBot) in (#604)

Contributors

• @rmargar (https://github.com/rmargar)
• @renovate[bot] (https://github.com/apps/renovate)
• @gcatanese (https://github.com/gcatanese)
• @AdyenAutomationBot (https://github.com/AdyenAutomationBot)

Full Changelog: v21.2.2...HEAD