Skip to main content
You can control where a prepaid Visa card can be spent by attaching a Runa-authored spend rule template to the card. A template bundles a set of restrictions — such as Merchant Category Code (MCC) allow/deny lists — that are applied to the issued card.

​
Attaching a template

To attach a template, add a usage_config object to the SINGLE product and set its spend_rules_template_id to the identifier of the template you want to apply.
Example Prepaid Visa Card order with a spend rule template
POST https://api.runa.io/v2/order
Content-Type: application/json
X-Api-Key: <your API key>

{
    "payment_method": {
        "type": "ACCOUNT_BALANCE",
        "currency": "USD"
    },
    "items": [
        {
            "face_value": 10,
            "distribution_method": {
                "type": "EMAIL",
                "email_address": "<your recipient's email address>"
            },
            "products": {
                "type": "SINGLE",
                "value": "VISASL-3M-USD",
                "usage_config": {
                    "spend_rules_template_id": "<runa authored template id>"
                }
            }
        }
    ]
}
When you set usage_config on an order, it is returned in the order details so you can confirm which template was applied.
A spend rule template defines the spending pattern enforced on a card, based on MCC rules — each rule either allows or blocks transactions for a given merchant category. Multiple rules can be bundled into a single template, and one template is applied per card. Templates are authored by Runa. If you have a business case that needs one, reach out to your Account Manager or email support@runa.io — we’ll create the template for you.
usage_config only applies to prepaid Visa cards. If you set it on any other product it is ignored.