closedhumanPR #208Payments

Add reusable Prava payments adapter for NANDA Town

Adds an installable nest.plugins.payments adapter backed by Prava Session APIs. It implements quote, pay, verify and merchant-owned refund handling, plus a one-payment interactive sandbox scenario and tests.

Author

Status
Closed without merging
Opened on
Aug 1
Branch
hackathon/somuai-prava-adapter

Description

The pitch.

## Summary

Adds an installable `nest.plugins.payments` adapter backed by Prava Session APIs. It implements quote, pay, verify and merchant-owned refund handling, plus a one-payment interactive sandbox scenario and tests.

## Safety properties

- requires card + passkey approval before merchant execution
- never stores or returns Prava token/CVV fields
- idempotent payment references
- reports approved and declined merchant outcomes to Prava
- fails closed when no merchant executor or refund handler is configured
- documents Prava's current refund boundary accurately (merchant-owned; no separate Prava refund endpoint)

## Verification

- `make ci-local`: 1318 passed, 1 skipped, 2 live tests deselected
- adapter tests: 7 passed, including decline, duplicate, refund and credential-erasure paths
- entry point resolves as `payments/prava -> PravaPayments`

## Live sandbox gate

The interactive test is intentionally marked `live` and excluded from ordinary CI. A fresh Prava sandbox card + passkey transaction will be attached during the hackathon before this PR is marked ready. The scenario reports a disclosed sandbox merchant outcome; it does not claim a real merchant charge.

Try it

Open PR on GitHubView diff

Checkout locally

git fetch origin pull/208/head:pr-208
git checkout pr-208