---
updatedAt: 2026-07-28T06:01:08.000Z
agentTools:
  projectIndex: https://docs.payplus.co.il/llms.txt
---

# Create Card

Creates an inactive card linked to an existing customer.
Supported types: GIFT, REFUND, MEAL.

 Keep card uuid for activation later.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Wittix Cards",
    "version": "0.1.1",
    "description": "Public Wittix Cards API definition.\nThis definition is scoped to card and transaction routes only."
  },
  "servers": [
    {
      "url": "https://api-dev.wittix.com/v1",
      "description": "Wittix Staging API"
    }
  ],
  "security": [
    {
      "AuthorizationHeader": []
    }
  ],
  "components": {
    "securitySchemes": {
      "AuthorizationHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization"
      }
    }
  },
  "tags": [
    {
      "name": "Cards"
    }
  ],
  "paths": {
    "/cards/cards/create": {
      "post": {
        "tags": [
          "Cards"
        ],
        "summary": "Create Card",
        "description": "Creates an inactive card linked to an existing customer.\nSupported types: GIFT, REFUND, MEAL.\n\n Keep card uuid for activation later.",
        "operationId": "wittix-cards-create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "company_uuid",
                  "type",
                  "expiry_month",
                  "expiry_year"
                ],
                "properties": {
                  "company_uuid": {
                    "type": "string",
                    "description": "Public PayPlus company UUID."
                  },
                  "customer_uuid": {
                    "type": "string",
                    "description": "Optional customer UUID to assign the card to."
                  },
                  "type": {
                    "type": "string",
                    "description": "Card type. Supported values: GIFT, REFUND, MEAL.",
                    "enum": [
                      "GIFT",
                      "REFUND",
                      "MEAL"
                    ]
                  },
                  "expiry_month": {
                    "type": "integer",
                    "description": "Card expiry month.",
                    "minimum": 1,
                    "maximum": 12
                  },
                  "expiry_year": {
                    "type": "integer",
                    "description": "Card expiry year.",
                    "minimum": 2000,
                    "maximum": 2199
                  }
                }
              },
              "examples": {
                "Create Card - With Customer": {
                  "value": {
                    "company_uuid": "{{company_uuid}}",
                    "customer_uuid": "{{customer_uuid}}",
                    "type": "GIFT",
                    "expiry_month": 12,
                    "expiry_year": 2028
                  }
                },
                "Create Card - Without Customer": {
                  "value": {
                    "company_uuid": "{{company_uuid}}",
                    "type": "GIFT",
                    "expiry_month": 12,
                    "expiry_year": 2028
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success response envelope",
            "content": {
              "application/json": {
                "examples": {
                  "Success": {
                    "value": {
                      "results": {
                        "status": "success",
                        "code": 0
                      },
                      "data": {
                        "uuid": "card-uuid",
                        "company_uuid": "payplus-company-uuid",
                        "customer_uuid": null,
                        "type": "GIFT",
                        "status": "inactive",
                        "last4": "1234",
                        "expiry_month": 12,
                        "expiry_year": 2028,
                        "balance": 0,
                        "currency": "ILS"
                      }
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "required": [
                    "results",
                    "data"
                  ],
                  "properties": {
                    "results": {
                      "type": "object",
                      "additionalProperties": true,
                      "required": [
                        "status",
                        "code"
                      ],
                      "properties": {
                        "status": {
                          "type": "string"
                        },
                        "code": {
                          "type": "integer"
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true,
                      "required": [
                        "uuid",
                        "company_uuid",
                        "customer_uuid",
                        "type",
                        "status",
                        "last4",
                        "expiry_month",
                        "expiry_year",
                        "balance",
                        "currency"
                      ],
                      "properties": {
                        "uuid": {
                          "type": "string"
                        },
                        "company_uuid": {
                          "type": "string"
                        },
                        "customer_uuid": {
                          "type": "string"
                        },
                        "type": {
                          "type": "string"
                        },
                        "status": {
                          "type": "string"
                        },
                        "last4": {
                          "type": "string"
                        },
                        "expiry_month": {
                          "type": "integer"
                        },
                        "expiry_year": {
                          "type": "integer"
                        },
                        "balance": {
                          "type": "integer"
                        },
                        "currency": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Error response envelope",
            "content": {
              "application/json": {
                "examples": {
                  "Error - Customer Not Found": {
                    "value": {
                      "results": {
                        "status": "error",
                        "code": -4,
                        "description": "CUSTOMER_NOT_FOUND",
                        "message": "Customer not found"
                      },
                      "data": null
                    }
                  },
                  "Error - Invalid Expiry": {
                    "value": {
                      "results": {
                        "status": "error",
                        "code": -3,
                        "description": "INVALID_EXPIRY_DATE",
                        "message": "Invalid expiry date"
                      },
                      "data": null
                    }
                  },
                  "Error - Unsupported Type": {
                    "value": {
                      "results": {
                        "status": "error",
                        "code": -1,
                        "description": "PARAMETERS_VALIDATION_FAILED",
                        "message": "Parameters validation failed"
                      },
                      "data": [
                        {
                          "instancePath": "/type",
                          "message": "must be equal to one of the allowed values"
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "required": [
                    "results",
                    "data"
                  ],
                  "properties": {
                    "results": {
                      "type": "object",
                      "additionalProperties": true,
                      "required": [
                        "status",
                        "code",
                        "description",
                        "message"
                      ],
                      "properties": {
                        "status": {
                          "type": "string"
                        },
                        "code": {
                          "type": "integer"
                        },
                        "description": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "nullable": true,
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Error response envelope",
            "content": {
              "application/json": {
                "examples": {
                  "Error - Missing Permission": {
                    "value": {
                      "results": {
                        "status": "error",
                        "code": -1,
                        "description": "INVALID_ACCESS_TOKEN",
                        "message": "Invalid access token"
                      },
                      "data": null
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "required": [
                    "results",
                    "data"
                  ],
                  "properties": {
                    "results": {
                      "type": "object",
                      "additionalProperties": true,
                      "required": [
                        "status",
                        "code",
                        "description",
                        "message"
                      ],
                      "properties": {
                        "status": {
                          "type": "string"
                        },
                        "code": {
                          "type": "integer"
                        },
                        "description": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "nullable": true,
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```