ramp-core-workflow-a

Ramp Core Workflow A

Overview

Issue and manage virtual cards with spending limits, policies, and lifecycle management.

Prerequisites

• Completed ramp-hello-world

Instructions

Step 1: Issue a Virtual Card

card = requests.post(f"{BASE}/cards", headers={**headers, "Content-Type": "application/json"}, json={
    "holder_name": "Jane Smith",
    "spending_restrictions": {
        "amount": 50000,        # $500.00 in cents
        "interval": "monthly",  # monthly, yearly, total
    },
    "display_name": "Marketing Software",
    "fulfillment": { "card_type": "virtual" },
})
card.raise_for_status()
card_id = card.json()["id"]
print(f"Virtual card issued: {card_id}")

Step 2: Update Card Limit

requests.patch(f"{BASE}/cards/{card_id}", headers={**headers, "Content-Type": "application/json"}, json={
    "spending_restrictions": {
        "amount": 100000,  # Increase to $1,000
        "interval": "monthly",
    },
})

Step 3: Suspend Card

requests.post(f"{BASE}/cards/{card_id}/suspend", headers=headers)
print(f"Card {card_id} suspended")

Step 4: Terminate Card

requests.post(f"{BASE}/cards/{card_id}/terminate", headers=headers)
print(f"Card {card_id} terminated")

Output

• Virtual card issued with spending limits
• Card limits updated
• Card suspended/terminated

Error Handling

Error	Cause	Solution
422 Invalid holder	User not found	Verify holder is a Ramp user
400 Invalid amount	Amount not in cents	Multiply dollars by 100
Card already terminated	Cannot modify	Check card state first

Resources

• Virtual Cards API
• Cards and Funds

Next Steps

Transaction management: ramp-core-workflow-b