Customer Purse API

API for customer purse

Get Customer Purse Transaction

post

Permission annotations:

Header parameters
KeystringRequired
SignstringRequired
Body

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses
200
OK
*/*
post
POST /api/v1/customer-purse/transaction/get HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 99

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "transactionId": "123e4567-e89b-12d3-a456-426614174000"
  }
}
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "amount": 1,
  "addressFrom": "text",
  "currency": "text",
  "transactionHash": "text",
  "transactionState": "MEM_POOL_FOUND",
  "complianceState": "UNCHECKED",
  "translationToAccountCompleted": true,
  "createdDate": "2025-07-30T10:53:50.356Z"
}

Find Customer Purse Transactions

post

Permission annotations:

Header parameters
KeystringRequired
SignstringRequired
Body

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses
200
OK
*/*
post
POST /api/v1/customer-purse/transaction/find HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 451

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "customerId": "123e4567-e89b-12d3-a456-426614174000",
    "currencyFilter": {
      "equals": "text",
      "notEquals": "text",
      "specified": true,
      "in": [
        "text"
      ],
      "notIn": [
        "text"
      ],
      "contains": "text",
      "doesNotContain": "text"
    },
    "transactionStateFilter": {
      "equals": "MEM_POOL_FOUND",
      "notEquals": "MEM_POOL_FOUND",
      "specified": true,
      "in": [
        "MEM_POOL_FOUND"
      ],
      "notIn": [
        "MEM_POOL_FOUND"
      ]
    },
    "pageNumber": 1,
    "pageSize": 1,
    "sort": "ASC",
    "properties": "text"
  }
}
{
  "result": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "amount": 1,
      "addressFrom": "text",
      "currency": "text",
      "transactionHash": "text",
      "transactionState": "MEM_POOL_FOUND",
      "complianceState": "UNCHECKED",
      "translationToAccountCompleted": true,
      "createdDate": "2025-07-30T10:53:50.356Z"
    }
  ],
  "page": 1,
  "size": 1,
  "total": 1,
  "totalElements": 1
}

Update Customer

post

Permission annotations:

Header parameters
KeystringRequired
SignstringRequired
Body

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses
200
OK
*/*
post
POST /api/v1/customer-purse/customer/update HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 124

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "email": "text",
    "description": "text"
  }
}
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "email": "text",
  "description": "text",
  "externalId": "text",
  "blocked": true
}

Unblock Customer

post

Permission annotations:

Header parameters
KeystringRequired
SignstringRequired
Body

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses
200
OK
*/*
post
POST /api/v1/customer-purse/customer/unblock HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 96

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "customerId": "123e4567-e89b-12d3-a456-426614174000"
  }
}
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "email": "text",
  "description": "text",
  "externalId": "text",
  "blocked": true
}

Get Customer

post

Permission annotations:

Header parameters
KeystringRequired
SignstringRequired
Body

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses
200
OK
*/*
post
POST /api/v1/customer-purse/customer/get HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 96

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "customerId": "123e4567-e89b-12d3-a456-426614174000"
  }
}
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "email": "text",
  "description": "text",
  "externalId": "text",
  "blocked": true
}

Get Customers by external id

post

Permission annotations:

Header parameters
KeystringRequired
SignstringRequired
Body

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses
200
OK
*/*
post
POST /api/v1/customer-purse/customer/external/get HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "externalId": "text"
  }
}
{
  "customers": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "email": "text",
      "description": "text",
      "externalId": "text",
      "blocked": true
    }
  ]
}

Create new Customer

post

Permission annotations:

Header parameters
KeystringRequired
SignstringRequired
Body

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses
200
OK
*/*
post
POST /api/v1/customer-purse/customer/create HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 100

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "email": "text",
    "description": "text",
    "externalId": "text"
  }
}
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "email": "text",
  "description": "text",
  "externalId": "text",
  "blocked": true
}

Block Customer

post

Permission annotations:

Header parameters
KeystringRequired
SignstringRequired
Body

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses
200
OK
*/*
post
POST /api/v1/customer-purse/customer/block HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 96

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "customerId": "123e4567-e89b-12d3-a456-426614174000"
  }
}
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "email": "text",
  "description": "text",
  "externalId": "text",
  "blocked": true
}

Get Customer Purse Address

post

Permission annotations:

Header parameters
KeystringRequired
SignstringRequired
Body

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses
200
OK
*/*
post
POST /api/v1/customer-purse/address/get HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 114

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "customerId": "123e4567-e89b-12d3-a456-426614174000",
    "currency": "text"
  }
}
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "address": "text"
}