Create a Card

POST

https://{{env}}-lb.simplifipay.com/v1/card

Card

The Create a Card endpoint creates/issues a card to a user under a Card Program. The card issued
using this endpoint would inherit the characteristics defined in its card program such as
authorization controls, velocity controls etc. Following are the properties of this endpoint.

Webhook Success

Webhook Failure

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Body

🟠400

🟠401UnauthorizedError

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://uat-lb.simplifipay.com/v1/card' \
--header 'Authorization;' \
--header 'requestUuid;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userUuid": "f5ba1741-983f-4f51-8375-701461c5bacc",
    "cardProgramUuid": "56db03b7-29ef-46e3-82ad-68b94abb051f",
    "instrument": "VIRTUAL"
}'

Response Example

200 - Example 1

{
    "uuid": "8105fb1b-852c-4d93-88eb-2fb2361d4b45",
    "userUuid": "7ace3a56-3cb1-44db-a81d-2735e54c7c15",
    "companyUuid": "10cdeb1d-c3af-4288-b770-5d7620171f37",
    "cardProgramUuid": "dfb04381-3a10-4185-9ed3-5a97f43dd1a2",
    "instrument": "VIRTUAL",
    "creationDate": "2025-02-28 13:31:00",
    "cardStatus": "PENDING",
    "expiryDate": "12/31",
    "maskedPan": "**********1234",
    "cardMode": "PRIMARY",
    "currency": "USD"
}

Modified at 2026-03-24 11:35:31

List all Cards

Get Card Details