Kobble
  1. Cards
Kobble
  • Introduction
  • API Fundamentals
    • Idempotency
    • Rate Limits
  • Authorization
    • Authorization
    • Get access token
      POST
  • Beneficiaries
    • List all beneficiaries
      GET
    • Get beneficiary by ID
      GET
    • Create beneficiary
      POST
    • Update beneficiary
      PUT
  • Cards
    • Cards API
    • Get all cards
      GET
    • Create a new card
      POST
    • Get card by ID
      GET
    • Update card status
      PATCH
    • Replace or renew card
      POST
    • Generate card secret
      POST
  • Card Programs
    • Card Programs API
    • Get all programs
      GET
    • Create a new program
      POST
    • Get program by ID
      GET
  • Clients
    • Clients API
    • Get all clients
      GET
    • Get client by ID
      GET
    • Create a new client
      POST
    • Update client status
      PATCH
  • Endusers
    • Endusers API
    • Get all endusers
    • Create a new enduser
    • Get enduser by ID
  • Transactions
    • Transactions API
    • Get all transactions
    • Create a transaction
    • Get transaction by ID
    • Create manual credit transaction
    • Create manual debit transaction
  • Wallets
    • Wallets API
    • Get all wallets
    • Create a new wallet
    • Get wallet by ID
    • Update wallet
  • Relays
    • Relays API
    • Create subscription
  • Webhooks
    • Webhooks API
    • Webhook Signature Verification
    • Get all webhooks
    • Create a webhook
    • Delete a webhook
  1. Cards

Create a new card

POST
/customers/v1/cards
Create a new card with the specified wallet and program.

Request

Header Params

Body Params application/json

Example
{
    "wallet_id": "477f7da7-faeb-4497-b97a-d39e7e921d9f",
    "program_id": "ee3620d0-2f97-47a2-955d-b2975cc76747"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/customers/v1/cards' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'idempotency-key: {{$string.uuid}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "wallet_id": "477f7da7-faeb-4497-b97a-d39e7e921d9f",
    "program_id": "ee3620d0-2f97-47a2-955d-b2975cc76747"
}'

Responses

🟢201Created
application/json
Body

Example
{
    "id": "1b8ecc17-4edd-4b74-ae4f-208aeb78f105",
    "type": "VIRTUAL",
    "wallet_id": "13655985-8198-ffde-7afe-6abc661df281",
    "created_at": "2025-01-13T18:26:41.332Z",
    "updated_at": "2025-01-13T18:26:41.332Z",
    "status": "INACTIVE",
    "external_id": "1111111",
    "last_four_digit": "1111",
    "expiry": "2010-08-12T12:16:43.197Z",
    "program_id": "0e8563e6-d25e-0f83-18ac-d053dff141c3",
    "m_pan": "1111***1111"
}
Modified at 2025-01-27 04:35:38
Previous
Get all cards
Next
Get card by ID
Built with