Payout API
API for payouts
Permission annotations:
Object with request data
Merchant account ID. Request will be sent for this account
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
POST /api/v1/payout HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 112
{
"account": "text",
"timestamp": 1,
"payload": {
"id": "text",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000"
}
}
{
"id": "text",
"account": "text",
"depositAddress": "text",
"amount": 1,
"currency": "text",
"calypsoFee": 1,
"calypsoFeePercentage": 1,
"state": "CREATION_IN_PROGRESS",
"createdDate": "2025-06-30T16:56:37.160Z",
"transactionHash": "text",
"comment": "text",
"executionDate": "2025-06-30T16:56:37.160Z",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"errors": {
"withdrawalErrors": [
{
"withdrawalId": "text",
"errors": [
{
"id": 1,
"status": "SUCCESS",
"errorResolved": true,
"errorMessage": "text"
}
]
}
]
},
"cancellation": {
"canceledByUserId": "text",
"canceledByFirstname": "text",
"canceledByLastname": "text",
"cancelMessage": "text"
},
"belongingType": "INTERNAL"
}
Permission annotations:
Object with request data
Merchant account ID. Request will be sent for this account
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
POST /api/v1/payout/withdrawal HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 63
{
"account": "text",
"timestamp": 1,
"payload": {
"requestId": "text"
}
}
{
"id": "text",
"account": "text",
"companyName": "text",
"amount": 1,
"currency": "text",
"state": "DRAFT",
"calypsoFee": 1,
"transactionHash": "text",
"depositAddress": "text",
"comment": "text",
"createdDate": "2025-06-30T16:56:37.160Z",
"withdrawalErrors": [
{
"id": 1,
"status": "SUCCESS",
"errorResolved": true,
"errorMessage": "text"
}
],
"belongingType": "INTERNAL"
}
Permission annotations:
Object with request data
Merchant account ID. Request will be sent for this account
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
POST /api/v1/payout/withdrawal/all HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 168
{
"account": "text",
"timestamp": 1,
"payload": {
"stateNames": [
"DRAFT"
],
"pageNumber": 1,
"pageSize": 10,
"dealId": "text",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000"
}
}
{
"result": [
{
"id": "text",
"account": "text",
"companyName": "text",
"amount": 1,
"currency": "text",
"state": "DRAFT",
"calypsoFee": 1,
"transactionHash": "text",
"depositAddress": "text",
"comment": "text",
"createdDate": "2025-06-30T16:56:37.160Z",
"withdrawalErrors": [
{
"id": 1,
"status": "SUCCESS",
"errorResolved": true,
"errorMessage": "text"
}
],
"belongingType": "INTERNAL"
}
],
"page": 1,
"size": 1,
"total": 1,
"totalElements": 1
}
Permission annotations:
Object with request data
Merchant account ID. Request will be sent for this account
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
POST /api/v1/payout/mass HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 112
{
"account": "text",
"timestamp": 1,
"payload": {
"id": "text",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000"
}
}
{
"id": "text",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"companyId": "123e4567-e89b-12d3-a456-426614174000",
"account": "text",
"state": "CREATION_IN_PROGRESS",
"comment": "text",
"name": "text",
"currency": "text",
"totalWithdrawalAmount": 1,
"totalCalypsoFee": 1,
"totalCalypsoFeePercentage": 1,
"executionDate": "2025-06-30T16:56:37.160Z",
"errors": {
"withdrawalErrors": [
{
"withdrawalId": "text",
"errors": [
{
"id": 1,
"status": "SUCCESS",
"errorResolved": true,
"errorMessage": "text"
}
]
}
]
}
}
Permission annotations:
Object with request data
Merchant account ID. Request will be sent for this account
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
POST /api/v1/payout/mass/create HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 284
{
"account": "text",
"timestamp": 1,
"payload": {
"currency": "text",
"name": "text",
"comment": "text",
"massAddresses": [
{
"depositAddress": "text",
"amount": 1,
"comment": "text"
}
],
"executionDate": "2025-06-30T16:56:37.160Z",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"externalId": "text"
}
}
{
"id": "text",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"companyId": "123e4567-e89b-12d3-a456-426614174000",
"account": "text",
"state": "CREATION_IN_PROGRESS",
"comment": "text",
"name": "text",
"currency": "text",
"totalWithdrawalAmount": 1,
"totalCalypsoFee": 1,
"totalCalypsoFeePercentage": 1,
"executionDate": "2025-06-30T16:56:37.160Z",
"errors": {
"withdrawalErrors": [
{
"withdrawalId": "text",
"errors": [
{
"id": 1,
"status": "SUCCESS",
"errorResolved": true,
"errorMessage": "text"
}
]
}
]
}
}
Permission annotations:
Object with request data
Merchant account ID. Request will be sent for this account
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
POST /api/v1/payout/mass/cancel HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 133
{
"account": "text",
"timestamp": 1,
"payload": {
"dealId": "text",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"message": "text"
}
}
{
"id": "text",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"companyId": "123e4567-e89b-12d3-a456-426614174000",
"account": "text",
"state": "CREATION_IN_PROGRESS",
"comment": "text",
"name": "text",
"currency": "text",
"totalWithdrawalAmount": 1,
"totalCalypsoFee": 1,
"totalCalypsoFeePercentage": 1,
"executionDate": "2025-06-30T16:56:37.160Z",
"errors": {
"withdrawalErrors": [
{
"withdrawalId": "text",
"errors": [
{
"id": 1,
"status": "SUCCESS",
"errorResolved": true,
"errorMessage": "text"
}
]
}
]
}
}
Permission annotations:
Object with request data
Merchant account ID. Request will be sent for this account
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
POST /api/v1/payout/mass/all HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 138
{
"account": "text",
"timestamp": 1,
"payload": {
"stateNames": [
"CREATION_IN_PROGRESS"
],
"isExecutionDateInFuture": true,
"pageNumber": 1,
"size": 10
}
}
{
"result": [
{
"id": "text",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"companyId": "123e4567-e89b-12d3-a456-426614174000",
"account": "text",
"state": "CREATION_IN_PROGRESS",
"comment": "text",
"name": "text",
"currency": "text",
"totalWithdrawalAmount": 1,
"totalCalypsoFee": 1,
"totalCalypsoFeePercentage": 1,
"executionDate": "2025-06-30T16:56:37.160Z",
"errors": {
"withdrawalErrors": [
{
"withdrawalId": "text",
"errors": [
{
"id": 1,
"status": "SUCCESS",
"errorResolved": true,
"errorMessage": "text"
}
]
}
]
}
}
],
"page": 1,
"size": 1,
"total": 1,
"totalElements": 1
}
Permission annotations:
Object with request data
Merchant account ID. Request will be sent for this account
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
POST /api/v1/payout/create HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 233
{
"account": "text",
"timestamp": 1,
"payload": {
"depositAddress": "text",
"amount": 1,
"currency": "text",
"comment": "text",
"executionDate": "2025-06-30T16:56:37.160Z",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"externalId": "text"
}
}
{
"id": "text",
"account": "text",
"depositAddress": "text",
"amount": 1,
"currency": "text",
"calypsoFee": 1,
"calypsoFeePercentage": 1,
"state": "CREATION_IN_PROGRESS",
"createdDate": "2025-06-30T16:56:37.160Z",
"transactionHash": "text",
"comment": "text",
"executionDate": "2025-06-30T16:56:37.160Z",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"errors": {
"withdrawalErrors": [
{
"withdrawalId": "text",
"errors": [
{
"id": 1,
"status": "SUCCESS",
"errorResolved": true,
"errorMessage": "text"
}
]
}
]
},
"cancellation": {
"canceledByUserId": "text",
"canceledByFirstname": "text",
"canceledByLastname": "text",
"cancelMessage": "text"
},
"belongingType": "INTERNAL"
}
Permission annotations:
Object with request data
Merchant account ID. Request will be sent for this account
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
POST /api/v1/payout/cancel HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 133
{
"account": "text",
"timestamp": 1,
"payload": {
"dealId": "text",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"message": "text"
}
}
{
"id": "text",
"account": "text",
"depositAddress": "text",
"amount": 1,
"currency": "text",
"calypsoFee": 1,
"calypsoFeePercentage": 1,
"state": "CREATION_IN_PROGRESS",
"createdDate": "2025-06-30T16:56:37.160Z",
"transactionHash": "text",
"comment": "text",
"executionDate": "2025-06-30T16:56:37.160Z",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"errors": {
"withdrawalErrors": [
{
"withdrawalId": "text",
"errors": [
{
"id": 1,
"status": "SUCCESS",
"errorResolved": true,
"errorMessage": "text"
}
]
}
]
},
"cancellation": {
"canceledByUserId": "text",
"canceledByFirstname": "text",
"canceledByLastname": "text",
"cancelMessage": "text"
},
"belongingType": "INTERNAL"
}
Permission annotations:
Object with request data
Merchant account ID. Request will be sent for this account
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
POST /api/v1/payout/all HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 138
{
"account": "text",
"timestamp": 1,
"payload": {
"stateNames": [
"CREATION_IN_PROGRESS"
],
"isExecutionDateInFuture": true,
"pageNumber": 1,
"size": 10
}
}
{
"result": [
{
"id": "text",
"account": "text",
"depositAddress": "text",
"amount": 1,
"currency": "text",
"calypsoFee": 1,
"calypsoFeePercentage": 1,
"state": "CREATION_IN_PROGRESS",
"createdDate": "2025-06-30T16:56:37.160Z",
"transactionHash": "text",
"comment": "text",
"executionDate": "2025-06-30T16:56:37.160Z",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"errors": {
"withdrawalErrors": [
{
"withdrawalId": "text",
"errors": [
{
"id": 1,
"status": "SUCCESS",
"errorResolved": true,
"errorMessage": "text"
}
]
}
]
},
"cancellation": {
"canceledByUserId": "text",
"canceledByFirstname": "text",
"canceledByLastname": "text",
"cancelMessage": "text"
},
"belongingType": "INTERNAL"
}
],
"page": 1,
"size": 1,
"total": 1,
"totalElements": 1
}