Skip to content

Align SDK with 2026-06-29 API changes (Issuing, Payment Setups, Platforms ACH)#218

Merged
armando-rodriguez-cko merged 3 commits into
mainfrom
feature/api-align-2026-06-29
Jul 3, 2026
Merged

Align SDK with 2026-06-29 API changes (Issuing, Payment Setups, Platforms ACH)#218
armando-rodriguez-cko merged 3 commits into
mainfrom
feature/api-align-2026-06-29

Conversation

@armando-rodriguez-cko

Copy link
Copy Markdown
Contributor

Summary

Aligns the Python SDK with the 2026-06-29 swagger changes across Issuing, Payment Setups (Beta) and Platforms/Accounts.

Changes

Issuing — Cards

  • CardRequest: add activation_date. UpdateCardRequest: add activation_date + revocation_date.
  • ⚠️ BREAKING: removed the schedule-revocation endpoint — schedule_card_revocation/delete_card_revocation client methods and ScheduleCardRevocationRequest. Revocation scheduling now goes through UpdateCardRequest.revocation_date.

Issuing — Cardholders

  • ⚠️ BREAKING: removed document from CardholderRequest and deleted CardholderDocument (kept the shared common.enums.DocumentType).

Issuing — Disputes

  • New IssuingDisputeFraudDetails + IssuingDisputeFraudType (11-value enum).
  • Added fraud_details to CreateDisputeRequest and EscalateDisputeRequest.
  • New AmendDisputeRequest + amend_dispute (POST /issuing/disputes/{id}/amend, not deprecated).
  • Added submit_dispute (deprecated) + SubmitDisputeRequest — endpoint is still deprecated: true in the spec and was previously missing from the SDK.

Payment Setups (Beta)

  • PaymentSetupsRequest: added billing_descriptor, presentment_details, terminal + sub-models (PaymentSetup is the request body). latest_payment is readOnly → not modelled.
  • New Bacs/CardPresent/PayByBank/Stablecoin payment-method configs + nested types, wired into PaymentMethods.
  • New PaymentSetupAmountAllocation (+ AmountAllocationCommission) on Order.amount_allocations.
  • Correction: KlarnaAccountHolder.billing_addressname (matches the current spec; the old shape was wrong).

Platforms / Accounts

  • New InstrumentDetailsAch + InstrumentAccountType (savings/checking).

Tests

  • Serialization roundtrips for every new/changed property; fraud_type covered value-by-value (all 11).
  • amend/submit client unit tests; ACH + setup serialization specs; updated conftest and card/klarna integration tests.
  • 77 targeted unit tests pass.

Breaking changes (for release notes)

  1. Removal of the schedule-revocation methods/model.
  2. Removal of the cardholder document field and CardholderDocument.

Issuing cards:
- CardRequest: add activation_date; UpdateCardRequest: add activation_date + revocation_date
- Remove schedule-revocation endpoint (client methods + ScheduleCardRevocationRequest) [BREAKING]

Issuing cardholders:
- Remove document field from CardholderRequest + CardholderDocument (kept shared DocumentType) [BREAKING]

Issuing disputes:
- New IssuingDisputeFraudDetails + IssuingDisputeFraudType (11-value enum)
- Add fraud_details to CreateDisputeRequest and EscalateDisputeRequest
- New AmendDisputeRequest + amend_dispute (POST .../amend)
- Add deprecated submit_dispute + SubmitDisputeRequest (POST .../submit)

Payment Setups (Beta):
- PaymentSetupsRequest: add billing_descriptor, presentment_details, terminal (+ sub-models)
- New Bacs/CardPresent/PayByBank/Stablecoin payment-method configs
- New PaymentSetupAmountAllocation (+ commission) wired onto Order.amount_allocations
- KlarnaAccountHolder: replace billing_address with name (spec correction)

Platforms/Accounts:
- New InstrumentDetailsAch + InstrumentAccountType (savings/checking)

Tests: serialization roundtrips for all new/changed properties (fraud_type value-by-value),
amend/submit client unit tests, ACH + setup serialization specs; updated conftest and
card/klarna integration tests.
david-ruiz-cko
david-ruiz-cko previously approved these changes Jul 3, 2026
Swagger defines a fixed enum ['select_bank'] for PayByBankAction.type.
Introduce PayByBankActionType(str, Enum) and use it instead of a plain
str, per coding standards for fixed value sets. Serialization is
unchanged.
@sonarqubecloud

sonarqubecloud Bot commented Jul 3, 2026

Copy link
Copy Markdown

@armando-rodriguez-cko armando-rodriguez-cko merged commit a370894 into main Jul 3, 2026
4 checks passed
@armando-rodriguez-cko armando-rodriguez-cko deleted the feature/api-align-2026-06-29 branch July 3, 2026 10:41
armando-rodriguez-cko added a commit that referenced this pull request Jul 3, 2026
- Align SDK with 2026-06-29 API changes (Issuing, Payment Setups, Platforms ACH) (#218)
- feat: add authorization_type and payment_plan to payment request classes (#213)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants