Kobble
  1. Transactions
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 client by ID
    • Create a new client
    • Update client status
  • Endusers
    • Endusers API
    • Get all endusers
    • Create a new enduser
    • Get enduser by ID
  • Transactions
    • Transactions API
    • Get all transactions
      GET
    • Create a transaction
      POST
    • Get transaction by ID
      GET
    • Create manual credit transaction
      POST
    • Create manual debit transaction
      POST
  • 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. Transactions

Create a transaction

POST
/customers/v1/transactions
Create a new transaction with the provided details.

Request

Header Params

Body Params application/json

Examples
{
    "amount": 957,
    "reference": "dolore in",
    "metadata": {},
    "from": "ea95fda2-05cc-01e7-4a16-ade2d0bada83",
    "to": "abd5222d-5e66-8147-5e65-8ee84980f533",
    "payment_type": "AUD_DE_1"
}

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
curl --location --request POST '/customers/v1/transactions' \
--header 'idempotency-key: {{idempotency-key}}' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 957,
    "reference": "dolore in",
    "metadata": {},
    "from": "ea95fda2-05cc-01e7-4a16-ade2d0bada83",
    "to": "abd5222d-5e66-8147-5e65-8ee84980f533",
    "payment_type": "AUD_DE_1"
}'

Responses

🟢200OK
application/json
Body

Example
{
    "id": "9b1f05d8-f08f-4974-ae2b-df1e475e5024",
    "amount": 1,
    "asset": "AUD",
    "asset_class": "CURRENCY",
    "created_at": "2025-01-14T16:42:56.086Z",
    "external_id": "111",
    "from": "3d83ed2b-b760-4101-adf2-4f83ed57d366",
    "payment_type": "MANUAL_CREDIT",
    "reference": "in dolore nostrud sit velit",
    "status": "DECLINED",
    "to": "4e624f4c-d49c-4cb4-bda3-1c734042d134",
    "type": "RESERVATION",
    "updated_at": "2025-01-14T16:42:56.088Z",
    "metadata": {},
    "info": null
}
Modified at 2025-07-21 04:51:48
Previous
Get all transactions
Next
Get transaction by ID
Built with