closedhumanPR #213Payments

feat(payments): add nest-payments-prava plugin & CapSpend scenario

This PR introduces the Prava Agentic Payments Adapter (nest-payments-prava) for the NandaHack x Prava Agentic Commerce Hackathon. It enables any Nanda Town scenario to use Prava's Agentic Payments Sandbox via Visa Network Tokens.

Author

Status
Closed without merging
Opened on
Aug 2
Branch
hackathon/emarc-prava-adapter

Description

The pitch.

## Overview
This PR introduces the **Prava Agentic Payments Adapter (`nest-payments-prava`)** for the NandaHack x Prava Agentic Commerce Hackathon. It enables any Nanda Town scenario to use Prava's Agentic Payments Sandbox via Visa Network Tokens.

## Key Additions
* **Plugin Implementation:** Adds `PravaPaymentLayer` adhering to the standard `Payments` layer interface, integrated into the `nest-*` monorepo structure.
* **Error Handling:** Implements mandatory track guardrails, returning explicit `PaymentDeclined` states for over-limit transactions and sandbox test markers (CVV "000").
* **CapSpend Scenario:** Adds `capspend_marketplace.yaml`, demonstrating an autonomous solo `procurement_buyer` interacting with multi-merchant sellers (`software`, `cloud`, `hardware`). It successfully triggers both confirmed charges and expected limit declines.
* **100% Offline Testing:** Includes a full `pytest` suite using `respx` to mock external API calls, achieving 8/8 passing tests.

### Execution
To run the scenario locally:
`python -m nest_core.cli run scenarios/capspend_marketplace.yaml`

Try it

Open PR on GitHubView diff

Checkout locally

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