Create a cardholder

POST

/v1/issuing/cardholders

Creates a new Issuing Cardholder object that can be issued cards.

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Header Params

Body Params application/json

Example

{
    "billing": {
        "address": {
            "city": "string",
            "country": "string",
            "line1": "string",
            "line2": "string",
            "postal_code": "string",
            "state": "string"
        }
    },
    "name": "string",
    "email": "string",
    "phone_number": "string",
    "metadata": [
        {}
    ],
    "company": {
        "tax_id_provided": true
    },
    "individual": {
        "card_issuing": {
            "user_terms_acceptance": {
                "date": 0,
                "ip": "string",
                "user_agent": "string"
            }
        },
        "dob": {
            "day": 0,
            "month": 0,
            "year": 0
        },
        "first_name": "string",
        "last_name": "string",
        "verification": {
            "document": {
                "back": "string",
                "front": "string"
            }
        }
    },
    "spending_controls": {
        "spending_limits": {
            "amount": 0,
            "interval": "per_authorization"
        },
        "spending_limits_currency": "string"
    },
    "status": "active",
    "type": "individual"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://apitest.wooshpay.com/v1/issuing/cardholders' \
--header 'Accept;' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
    "billing": {
        "address": {
            "city": "string",
            "country": "string",
            "line1": "string",
            "line2": "string",
            "postal_code": "string",
            "state": "string"
        }
    },
    "name": "string",
    "email": "string",
    "phone_number": "string",
    "metadata": [
        {}
    ],
    "company": {
        "tax_id_provided": true
    },
    "individual": {
        "card_issuing": {
            "user_terms_acceptance": {
                "date": 0,
                "ip": "string",
                "user_agent": "string"
            }
        },
        "dob": {
            "day": 0,
            "month": 0,
            "year": 0
        },
        "first_name": "string",
        "last_name": "string",
        "verification": {
            "document": {
                "back": "string",
                "front": "string"
            }
        }
    },
    "spending_controls": {
        "spending_limits": {
            "amount": 0,
            "interval": "per_authorization"
        },
        "spending_limits_currency": "string"
    },
    "status": "active",
    "type": "individual"
}'

Responses

🟢200OK

application/json

Body

Example

{
    "id": "string",
    "object": "string",
    "billing": {
        "address": {
            "city": "string",
            "country": "string",
            "line1": "string",
            "line2": "string",
            "postal_code": "string",
            "state": "string"
        }
    },
    "name": "string",
    "email": "string",
    "phone_number": "string",
    "metadata": [
        {}
    ],
    "company": {
        "tax_id_provided": true
    },
    "created": 0,
    "individual": {
        "card_issuing": {
            "user_terms_acceptance": {
                "date": 0,
                "ip": "string",
                "user_agent": "string"
            }
        },
        "dob": {
            "day": 0,
            "month": 0,
            "year": 0
        },
        "first_name": "string",
        "last_name": "string",
        "verification": {
            "document": {
                "back": "string",
                "front": "string"
            }
        }
    },
    "livemode": true,
    "spending_controls": {
        "spending_limits": {
            "amount": 0,
            "interval": "per_authorization"
        },
        "spending_limits_currency": "string"
    },
    "status": "active",
    "type": "individual"
}

Modified at 2024-10-17 06:20:25

List all authorization

Update a cardholder