Issue card

Early access - contact your account manager to enable cards for your organization.

Issues a card to a person related to your organization. Set cardholderId to one of the persons returned by GET /integration/cardholders.

type selects the kind of card:

virtual - the card can be used for online payments as soon as it is issued;

physical - the card is also produced and sent to shipping.address, which is required for this type. The cardholder activates the card with POST /integration/cards/{id}/activate after receiving it.

cardholderName is the name printed on the card. It defaults to the cardholder's first and last name, can contain only Latin letters, spaces, hyphens and apostrophes, and must be the same on all cards of one cardholder. cardName is an optional label that helps you recognize the card; it is not printed on the card.

Cards spend from a card account in the currency of the card product. The first card opens this account, and later cards use the same account. The card account appears in GET /integration/accounts.

The response contains the card identifier, and the card starts in the issuing state. A virtual card is usually issued within seconds. The outcome is reported with the cardIssued or cardIssuanceFailed webhook; you can also poll GET /integration/cards/{id}. The issuance fee of the card product is charged after the card is issued.

limits optionally sets spending limits at issuance. They can be changed later with PUT /integration/cards/{id}/limits.

Errors: 400 Bad Request for invalid request data; 409 Conflict if a card for the same cardholder and card product is already being issued, or cardholderName differs from the name on the cardholder's other cards; 422 Unprocessable Content if the card cannot be issued for any other reason, for example when the card product is not available to your organization.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/json

Example

{
    "cardProductId": "06776ac8-abe1-475b-92ee-72405c7b0e60",
    "cardholderId": "29de7042-59a4-4af9-acc9-c12b40cdf661",
    "type": "virtual",
    "cardholderName": "ANNA SCHMIDT",
    "cardName": "Marketing subscriptions",
    "shipping": {
        "address": {
            "streetLine1": "string",
            "streetLine2": "string",
            "city": "string",
            "state": "string",
            "zip": "string",
            "country": "string"
        },
        "recipientName": "Anna Schmidt",
        "phoneNumber": "+4930123456789"
    },
    "limits": [
        {
            "amount": 1000,
            "interval": "perAuthorization"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Request

Request Code Samples

Responses