Skip to main content
POST
/
virtual-cards
/
action
/
card
/
user
Create Card User
curl --request POST \
  --url https://getmipay.com/api/v1/virtual-cards/action/card/user \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "first_name": "Doe",
  "last_name": "John",
  "email": "john@gmail.com",
  "country_code": "+237",
  "contact": "697028808",
  "dob": "1985-05-15T18:36:57+00:00",
  "billing_address": "Logbessou",
  "billing_city": "Douala",
  "billing_country": "CM",
  "billing_state": "Littoral",
  "billing_postal_code": "1234",
  "id_number": "125464",
  "is_business": false,
  "business_name": null
}
'
{
  "success": true,
  "message": "Virtual card user created successfully",
  "data": {
    "id": 12,
    "merchant_id": 3,
    "reference": "SP6A9F21D0VC",
    "first_name": "Alex",
    "last_name": "Moris",
    "email": "alex.moris@example.com",
    "contact": "690112233",
    "dob": "1994-03-21T00:00:00.000000Z",
    "country_code": "237",
    "billing_name": "Alex Moris",
    "is_business": false,
    "business_name": null,
    "billing_address": "Carrefour Bastos",
    "billing_city": "Yaoundé",
    "billing_country": "CM",
    "billing_state": "Centre",
    "billing_postal_code": "00123",
    "id_number": "CNI004829191",
    "status": "active",
    "created_at": "2025-10-02T12:45:30.000000Z",
    "updated_at": "2025-10-02T12:45:30.000000Z"
  }
}

Authorizations

X-API-KEY
string
header
required

Body

application/json

User creation details

first_name
string
required
Example:

"Doe"

last_name
string
required
Example:

"John"

email
string<email>
required
Example:

"john@gmail.com"

country_code
string
required
Example:

"+237"

contact
string
required
Example:

"697028808"

dob
string<date-time>
required
Example:

"1985-05-15T18:36:57+00:00"

billing_address
string
required
Example:

"Logbessou"

billing_city
string
required
Example:

"Douala"

billing_country
string
required
Example:

"CM"

billing_state
string
required
Example:

"Littoral"

billing_postal_code
string
required
Example:

"1234"

id_number
string
required
Example:

"125464"

is_business
boolean
Example:

false

business_name
string | null
Example:

null

Response

User created successfully

success
boolean
Example:

true

message
string
Example:

"Virtual card user created successfully"

data
object