Create Card

Use this API to create a Virtual Card. Virtual cards can belong to either a Business or a Person.

post/card

Request

Base URL
https://api.useoval.com
Auth
API key in header Authorization
TypeScript
https://skmtc.dev/useoval/apis/core-api/docs/card/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

person_idstring

Pass this if the owner of the card is a person

business_idstring

Pass this if the owner of the card is a business

labelstring required

funding_amountinteger required

A minimum of $5.00 is usually required to create a card with an initial balance. Amount should be in subunits, e.g. $1 should be sent as 100.

Response

200

messagestring

metaunknown

statusstring

Example response

{
  "data": {
    "id": "15f2267fb02f11ed9e800242ac110002",
    "holder_id": "c74b2fb8a59911eda9df0242ac110002",
    "holder_type": "person",
    "currency": "USD",
    "label": "Sandbox",
    "cardholder_name": "JOHN DERRICK",
    "status": "pending",
    "created_at": "2023-02-19T08:26:19Z",
    "updated_at": "2023-02-19T08:26:19Z"
  },
  "message": "Card creation queued successfully",
  "status": "success"
}

Changes

No recorded changes to this operation across all 1 revision of this API.