---
title: "Create Partner Card"
method: POST
path: "/partner_cards"
tags: ["Cards"]
---

# Create Partner Card

`POST /partner_cards`

Create a partner card for business transactions. This API allows you to issue virtual cards with specific limits and controls for your business partners. This API is available upon request for a tailored integration. Email us on api@mamopay.com to get started.

## Request body

- object
  - `amount` number, required — The amount limit for the partner card.
  - `email` string, required — Cardholder’s email address. Card holder must have completed KYC.
  - `booking_id` string, required — Booking reference in case the card will be used for a 1 time booking.
  - `verification_email` string, email, required — The email address that will be used for verification purposes.
  - `transactions_limit` number, required — Maximum number of transactions allowed on the card.

## Response `200`

Successful response

- object
  - `card_holder_name` string — Name of the card holder
  - `expiry_date` string — Card expiry date in MM/YY format
  - `card_last4` string — Last 4 digits of the card number
  - `status` 'active' | 'inactive' | 'expired' — Current status of the card
  - `booking_id` string — Booking reference associated with the card
  - `created_at` string, date-time — Card creation timestamp
  - `updated_at` string, date-time — Card last update timestamp
  - `id` string — Unique card identifier
  - `amount` number — Card amount limit
  - `total_spend` number — Total amount spent on the card
  - `url` string — URL to access the card details with authentication token

## Other responses

- `403` — Unauthorised
- `404` — Invalid request
- `422` — Unprocessable entity
- `500` — Unexpected error

---

[API](https://skmtc.net/mamopay/apis/cards.md) · [All operations](https://skmtc.net/mamopay/apis/cards/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mamopay/cards/versions/9bdabbad57b0/schema)