Skip to content

Add SDK QR payload parser for payments #335

Description

@El-swaggerito

Description

Difficulty: Hard

Type: Feature

Summary

Implement a QR payment payload parser for address, amount, asset, memo, and optional metadata.

Current Behaviour

Mobile payment QR flows may need to parse payloads without duplicating logic outside the SDK.

Expected Behaviour

The SDK should expose a safe QR parser that validates supported payment payload structures.

Suggested Implementation

Create parser types, validation rules, error mapping, payment intent conversion, tests, and documentation.

Files or Areas Likely Affected

  • src/payments/
  • src/wallet/
  • src/types/
  • src/errors/
  • tests/
  • docs/

Acceptance Criteria

  • QR payment payload parser is implemented.
  • Address, amount, asset, and memo fields are validated.
  • Invalid payloads return typed errors.
  • Parsed payload can become payment intent input.
  • Tests cover valid, invalid, partial, and malformed payloads.
  • Documentation explains supported QR format.

Additional Notes

This should support mobile scan-to-pay flows.

Metadata

Metadata

Assignees

Labels

GrantFox OSSIssue tracked for GrantFox OSS contributionMaybe RewardedIssue may be eligible for a GrantFox rewardOfficial Campaign | FWC26Official GrantFox campaign labelfeatureFeature workhardHard difficultypaymentsPayment flow related worksdkSDK related workwalletWallet related work

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions