Claude Code Setup
Configure Claude Code CLI to work with RohoPay projects.
Prerequisites
- Claude Code installed (
npm install -g @anthropic-ai/claude-code) - An Anthropic account with API access
- Your RohoPay project repository
Setup
1. Install Claude Code
npm install -g @anthropic-ai/claude-code
Verify:
claude --version
2. Add RohoPay Context to CLAUDE.md
Create or update CLAUDE.md in your project root to include RohoPay context:
# RohoPay Integration
## API Base URL
- Production: https://api.rohopay.com
## Authentication
- All `/api/v1/*` endpoints: `Authorization: Bearer {api_key}`
- Prefix `test_` = sandbox, `live_` = production
- Mutation endpoints REQUIRE `Idempotency-Key: {uuid}` header
## Core Endpoints
- POST /api/v1/collect — mobile money collection
- POST /api/v1/disburse — mobile money disbursement (live only)
- GET /api/v1/transactions/:ref — check status
- GET /api/v1/wallet/balance — wallet balance
- POST /api/v1/checkout — card payment (Visa/MC, api_key in body)
## Webhook Verification
- All webhooks: HMAC-SHA256 in `X-RohoPay-Signature` header
- Secret from env: ROHOPAY_WEBHOOK_SECRET
## Phone Format
- International format without +: 256XXXXXXXXX (Uganda), 254XXXXXXXXX (Kenya)
- Pattern: ^(256|254|255|250)[0-9]{7,12}$
## Transaction Statuses
- pending → successful | failed (terminal)
## Digital Products
- POST /api/v2/digital/products — create product (session auth)
- POST /api/v2/digital/links — create payment link (session auth)
- GET /api/v2/public/checkout/:slug — public checkout page data (no auth)
- POST /api/v2/public/checkout/:slug/pay — process payment (rate limited)
- GET /api/v2/public/checkout/:slug/order/:id — poll order status
## Test Cards
- Visa success: 4111 1111 1111 1111
- Visa decline: 4000 0000 0000 0002
- MC success: 5500 0000 0000 0004
- MC decline: 5200 8282 8210 0001
## Test Mobile Numbers (Iotec sandbox, test_ key only)
- Success: 011177777(0-9) / 25611177777(0-9)
- Failed: 011177799(0-9) / 25611177799(0-9)
- Pending: 011177778(0-9) / 25611177778(0-9)
- SentToVendor: 011177779(0-9) / 25611177779(0-9)
## Available Skills
- /rohopay-collect — mobile money collection handler
- /rohopay-webhook — webhook handler with HMAC verification
- /rohopay-card — card payment 3D Secure flow
- /rohopay-errors — error code reference
- /rohopay-digital — digital products and payment links
## Application Structure
- apps/api — Go backend (Gin) — payment API
- apps/admin — Next.js merchant dashboard
- apps/web — Next.js marketing site
- apps/digital — Next.js digital checkout
3. Start Claude Code
cd your-project
claude
Claude will automatically read CLAUDE.md and have full context about your RohoPay integration.
Using Claude for RohoPay Tasks
Generate a Collection Handler
> Write a TypeScript function that collects a mobile money payment
> and polls until it resolves, with proper error handling
Claude will generate code using the correct endpoint, headers, and idempotency patterns.
Debug a Webhook
> My webhook isn't receiving events. Here's my handler: [paste code]
Claude will check the signature verification, response timing, and content-type handling.
Review Integration
> Review my RohoPay integration in src/payments/ for correctness and security
Generate Tests
> Write Jest tests for my RohoPay webhook handler covering:
> - successful payment
> - failed payment
> - invalid signature
> - missing idempotency key
Project-Level Settings (.claude/settings.json)
Add RohoPay-specific allowed commands to avoid permission prompts:
{
"permissions": {
"allow": [
"Bash(curl:*)",
"Bash(go test:*)",
"Bash(pnpm test:*)"
]
},
"env": {
"ROHOPAY_API_KEY": "test_xxx",
"ROHOPAY_WEBHOOK_SECRET": "your-secret"
}
}
Claude Code Skills
Install the skills to get quick-access slash commands:
# After installing skills (see /ai-setup/skills)
/rohopay-collect — mobile money collection handler
/rohopay-webhook — webhook handler with HMAC verification
/rohopay-card — card payment 3D Secure flow
/rohopay-errors — error code reference
/rohopay-digital — digital products and payment links
Troubleshooting
Claude doesn't know the API endpoints
Make sure CLAUDE.md is in the root of your working directory when you start claude. Claude Code reads CLAUDE.md automatically at startup.
Claude generates wrong phone format
Add this to your CLAUDE.md: "Always use international format for East African phone numbers: remove leading 0, add country code (256 for Uganda, 254 for Kenya)."
Claude uses wrong authentication pattern
Emphasize in CLAUDE.md: "The /api/v1/checkout endpoint takes api_key in the REQUEST BODY, not in the Authorization header. All other /api/v1/* endpoints use Authorization: Bearer header."