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

Cards API

Kobble Card API Documentation#

Overview#

The Card API is a powerful prepaid card management solution that allows you to generate, manage, and maintain virtual cards seamlessly. It is designed to handle your customer’s balances securely, with Kobble taking responsibility for storing balances and authorizing transactions according to defined limits and balances.

Key Features#

Instant Virtual Card Issuance: Generate and issue virtual cards effortlessly.
Balance Management: Kobble securely stores customer balances and ensures transactions comply with defined card limits.
Flexible Card Operations:
Generate new cards
Update card statuses
Replace or renew existing cards
Generate time based secret

Why Choose the Card API?#

Use the Card API if you need a reliable partner to store customer balances and manage transaction authorizations securely and efficiently. Kobble simplifies the complexities of virtual card management, enabling you to focus on delivering exceptional services to your customers.

Base URLs#

Use the appropriate base URL depending on the environment:
Development: https://dev.apikobble.net/
Staging: https://staging.apikobble.net/
Ensure you prepend the base URL to each endpoint while making requests.

API Endpoints#

Get all Cards
Generate New Card
Get Card by Card ID
Update Card Status
Replace Existing Card
Renew Card
Generate Time-Based Secret for a Card

Authentication#

All requests to the Card API require an access token. Include the access token in the headers of each request:
Header: Authorization: Bearer {access_token}
To generate an access token, please refer to Authorization.

Error Handling#

The API returns standard HTTP status codes to indicate the success or failure of a request.

Common Status Codes#

Status CodeDescription
200OK - Request succeeded.
400Bad Request - Invalid parameters or missing data.
401Unauthorized - Invalid credentials or token.
403Forbidden - The client is not allowed access to the requested resource.
404Not Found - The requested resource could not be found.
500Internal Server Error - An issue occurred on the server.
Modified at 2025-10-27 02:12:23
Previous
Update beneficiary
Next
Get all cards
Built with