Creates a card
You can use this endpoint to create cards
Authorization
authorization
AuthorizationBearer <token>
In: header
Header Parameters
x-idempotency-key?string
Idempotency key in UUID format
Format
uuidExample
"f30f1d0b-795f-49f5-80dc-41a7bffccfde"Request Body
application/json
Attributes to create a card
account_idstring
Account ID
Match
^[A-Za-z]{2,6}_[\w-]{22}$Example
"lacc_5tgliBmzjZ6mpQPRbQjfKj"cardholder?Cardholder
Represents the cardholder information
cardholder_id?string|null
Cardholder ID
Match
^[A-Za-z]{2,6}_[\w-]{22}$Example
"carh_5tgliBmzjZ6mpQPRbQjfKj"configuration_group_idstring
Identifier of the card configuration, you can check it on the endpoint /v1/ledger/tenant/config
Match
^[A-Za-z]{2,6}_[\w-]{22}$Example
"ccg_5tgliBmzjZ6mpQPRbQjfKj"nickname?string|null
Card nickname
Example
"Travel card"spending_controls?object|null
Spending controls relate to the card
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.cert.monoban.co/v1/ledger/cards" \ -H "Content-Type: application/json" \ -d '{ "account_id": "lacc_5tgliBmzjZ6mpQPRbQjfKj", "configuration_group_id": "ccg_5tgliBmzjZ6mpQPRbQjfKj" }'{
"account_id": "lacc_5tgliBmzjZ6mpQPRbQjfKj",
"cardholder": {
"address": {
"city": "Chapinero",
"country": "CO",
"extra": "Location near the southeast corner in front of the ABC mall. deliver to the security guard pedro pruebas",
"line_1": "Calle 97 # 15-24",
"line_2": "Apto. 208",
"state": "Bogota D.C",
"zip_code": "110221"
},
"birthdate": "1941-09-09",
"document": {
"country_code": "CO",
"number": "1023711432",
"person_type": "natural",
"type": "CC"
},
"email": "someone@gmail.com",
"first_name": "Dennis",
"id": "carh_5tgliBmzjZ6mpQPRbQjfKj",
"last_name": "Alistair",
"middle_name": "Mac",
"nationality": "CO",
"phone_number": "+573000000000",
"second_last_name": "Ritchie"
},
"cardholder_id": "carh_5tgliBmzjZ6mpQPRbQjfKj",
"configuration_group_id": "ccg_5tgliBmzjZ6mpQPRbQjfKj",
"id": "car_5tgliBmzjZ6mpQPRbQjfKj",
"last_four": "0745",
"nickname": "Travel card",
"spending_controls": {
"card_target": "spc_5tgliBmzjZ6mpQPRbQjfKj",
"configuration_group_target": "spc_5tgliBmzjZ6mpQPRbQjfKj"
},
"state": "active",
"type": "virtual"
}{
"account_id": "lacc_5tgliBmzjZ6mpQPRbQjfKj",
"cardholder": {
"address": {
"city": "Chapinero",
"country": "CO",
"extra": "Location near the southeast corner in front of the ABC mall. deliver to the security guard pedro pruebas",
"line_1": "Calle 97 # 15-24",
"line_2": "Apto. 208",
"state": "Bogota D.C",
"zip_code": "110221"
},
"birthdate": "1941-09-09",
"document": {
"country_code": "CO",
"number": "1023711432",
"person_type": "natural",
"type": "CC"
},
"email": "someone@gmail.com",
"first_name": "Dennis",
"id": "carh_5tgliBmzjZ6mpQPRbQjfKj",
"last_name": "Alistair",
"middle_name": "Mac",
"nationality": "CO",
"phone_number": "+573000000000",
"second_last_name": "Ritchie"
},
"cardholder_id": "carh_5tgliBmzjZ6mpQPRbQjfKj",
"configuration_group_id": "ccg_5tgliBmzjZ6mpQPRbQjfKj",
"id": "car_5tgliBmzjZ6mpQPRbQjfKj",
"last_four": "0745",
"nickname": "Travel card",
"spending_controls": {
"card_target": "spc_5tgliBmzjZ6mpQPRbQjfKj",
"configuration_group_target": "spc_5tgliBmzjZ6mpQPRbQjfKj"
},
"state": "active",
"type": "virtual"
}{
"code": "400 Bad Request",
"errors": [
{
"error_code": "validation_error",
"message": "Generic changeset errors",
"path": null,
"url": null
}
],
"id": "log_7MkWaFqvfosB8fzHhb1Eql",
"message": "Malformed request"
}{
"code": "401 Unauthorized",
"errors": [
{
"error_code": "expired_token",
"message": "The token is expired, inactive, or doesn't exist.",
"path": null,
"url": null
}
],
"id": "log_7MkWaFqvfosB8fzHhb1Eql",
"message": "Authorization header is missing or invalid."
}{
"code": "403 Forbidden",
"errors": [
{
"error_code": "not_authorized",
"message": "Not authorized to have access to this resource.",
"path": null,
"url": null
}
],
"id": "log_7MkWaFqvfosB8fzHhb1Eql",
"message": "Not authorized to have access to this resource"
}{
"code": "422 Unprocessable Entity",
"errors": [
{
"error_code": "missing_field",
"message": "The field is missing on the request body or parameters.",
"path": "#/path/to/field",
"url": null
}
],
"id": "log_7MkWaFqvfosB8fzHhb1Eql",
"message": "Validation errors"
}