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

Copy link
Copy Markdown

@armando-rodriguez-cko
armando-rodriguez-cko merged commit a370894 into mainJul 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-ckoarmando-rodriguez-cko mentioned this pull request Jul 3, 2026
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 freeto 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

@armando-rodriguez-cko@david-ruiz-cko