Skip to content

Rewrite README as an integration guide - #138

Merged
peter-paystack merged 1 commit into
mainfrom
chore/Updating-Readme
Oct 16, 2026
Merged

peter-paystack merged 1 commit into
mainfrom
chore/Updating-Readme

Conversation

@peter-paystack

Copy link
Copy Markdown
Collaborator

The README covered the example apps and a bare-bones SDK import but
left integrators to work out the rest. Restructure it around the flow
someone actually follows when adding the SDK to an app.

  • Add Requirements (iOS 14+ for the payment flow, Swift 5.7+) and an Installation section that leads with SPM and notes CocoaPods is local-pod only and goes away on 2 December 2026
  • Spell out the three-step payment sequence: initialize on the server, charge in the app, verify on the server before giving value
  • Document the builder options (setDisplayAudience, enableLogging) and give TransactionResult its own section with a case-by-case table
  • Add a supported payment methods table per country/currency, and note that channels the SDK doesn't support yet aren't shown
  • Promote Display audience to a top-level section describing how Zap, Scan to Pay and Bank Transfer / Pesalink differ per audience
  • Add Appearance (light/dark mode) and Testing sections
  • Expand the example app instructions with the pod install step

  The README covered the example apps and a bare-bones SDK import but
  left integrators to work out the rest. Restructure it around the flow
  someone actually follows when adding the SDK to an app.

  - Add Requirements (iOS 14+ for the payment flow, Swift 5.7+) and an
    Installation section that leads with SPM and notes CocoaPods is
    local-pod only and goes away on 2 December 2026
  - Spell out the three-step payment sequence: initialize on the server,
    charge in the app, verify on the server before giving value
  - Document the builder options (setDisplayAudience, enableLogging) and
    give TransactionResult its own section with a case-by-case table
  - Add a supported payment methods table per country/currency, and note
    that channels the SDK doesn't support yet aren't shown
  - Promote Display audience to a top-level section describing how Zap,
    Scan to Pay and Bank Transfer / Pesalink differ per audience
  - Add Appearance (light/dark mode) and Testing sections
  - Expand the example app instructions with the pod install step
@peter-paystack peter-paystack self-assigned this Oct 16, 2026
@peter-paystack peter-paystack added the enhancement New feature or request label Oct 16, 2026
@peter-paystack
peter-paystack marked this pull request as ready for review October 16, 2026 08:32
@sonarqubecloud

Copy link
Copy Markdown

@peter-paystack
peter-paystack merged commit 1a08e6a into main Oct 16, 2026
5 of 6 checks passed
@peter-paystack
peter-paystack deleted the chore/Updating-Readme branch October 16, 2026 10:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants