Payment Widget API

API for payment widgets

Get Unlimited Linked Payment widget by ID

post

Permission annotations:

Header parameters

KeystringRequired

SignstringRequired

Body

application/json

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

*/*

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/payment-widget/unlimited-linked/find

HTTPcURLJavaScriptPython

POST /api/v1/payment-widget/unlimited-linked/find HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 95

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "requestId": "123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
  "cryptoCurrencies": [
    "text"
  ],
  "description": "text",
  "widgetType": "SINGLE_FIAT",
  "widgetState": "IN_PROGRESS",
  "logoUrl": "text",
  "returnUrl": "text",
  "supportUrl": "text",
  "externalId": "text",
  "invoices": [
    {
      "invoiceId": "text",
      "cryptoCurrency": "text",
      "invoiceIdempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
      "invoiceExternalId": "text"
    }
  ],
  "createdDate": "2025-12-08T08:36:26.584Z",
  "expiration": "2025-12-08T08:36:26.584Z"
}

Create new Unlimited Linked payment widget

post

Permission annotations:

Header parameters

KeystringRequired

SignstringRequired

Body

application/json

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

*/*

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/payment-widget/unlimited-linked/create

HTTPcURLJavaScriptPython

POST /api/v1/payment-widget/unlimited-linked/create HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 265

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "cryptoCurrencies": [
      "text"
    ],
    "description": "text",
    "logoUrl": "text",
    "returnUrl": "text",
    "supportUrl": "text",
    "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
    "externalId": "text",
    "expiration": "2025-12-08T08:36:26.584Z"
  }
}

{
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
  "cryptoCurrencies": [
    "text"
  ],
  "description": "text",
  "widgetType": "SINGLE_FIAT",
  "widgetState": "IN_PROGRESS",
  "logoUrl": "text",
  "returnUrl": "text",
  "supportUrl": "text",
  "externalId": "text",
  "invoices": [
    {
      "invoiceId": "text",
      "cryptoCurrency": "text",
      "invoiceIdempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
      "invoiceExternalId": "text"
    }
  ],
  "createdDate": "2025-12-08T08:36:26.584Z",
  "expiration": "2025-12-08T08:36:26.584Z"
}

Archive Unlimited Linked Payment widget by ID

post

Permission annotations:

Header parameters

KeystringRequired

SignstringRequired

Body

application/json

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

*/*

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/payment-widget/unlimited-linked/archive

HTTPcURLJavaScriptPython

POST /api/v1/payment-widget/unlimited-linked/archive HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 95

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "requestId": "123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
  "cryptoCurrencies": [
    "text"
  ],
  "description": "text",
  "widgetType": "SINGLE_FIAT",
  "widgetState": "IN_PROGRESS",
  "logoUrl": "text",
  "returnUrl": "text",
  "supportUrl": "text",
  "externalId": "text",
  "invoices": [
    {
      "invoiceId": "text",
      "cryptoCurrency": "text",
      "invoiceIdempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
      "invoiceExternalId": "text"
    }
  ],
  "createdDate": "2025-12-08T08:36:26.584Z",
  "expiration": "2025-12-08T08:36:26.584Z"
}

Get all Unlimited Linked Payment widgets

post

Permission annotations:

Header parameters

KeystringRequired

SignstringRequired

Body

application/json

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

*/*

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/payment-widget/unlimited-linked/all

HTTPcURLJavaScriptPython

POST /api/v1/payment-widget/unlimited-linked/all HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 100

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "widgetStates": [
      "IN_PROGRESS"
    ],
    "pageNumber": 1,
    "size": 10
  }
}

{
  "result": [
    {
      "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
      "cryptoCurrencies": [
        "text"
      ],
      "description": "text",
      "widgetType": "SINGLE_FIAT",
      "widgetState": "IN_PROGRESS",
      "logoUrl": "text",
      "returnUrl": "text",
      "supportUrl": "text",
      "externalId": "text",
      "invoices": [
        {
          "invoiceId": "text",
          "cryptoCurrency": "text",
          "invoiceIdempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
          "invoiceExternalId": "text"
        }
      ],
      "createdDate": "2025-12-08T08:36:26.584Z",
      "expiration": "2025-12-08T08:36:26.584Z"
    }
  ],
  "page": 1,
  "size": 1,
  "total": 1,
  "totalElements": 1
}

Get Single Fiat Payment widget by ID

post

Permission annotations:

Header parameters

KeystringRequired

SignstringRequired

Body

application/json

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

*/*

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/payment-widget/single-fiat/find

HTTPcURLJavaScriptPython

POST /api/v1/payment-widget/single-fiat/find HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 95

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "requestId": "123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
  "cryptoCurrencies": [
    "text"
  ],
  "widgetType": "SINGLE_FIAT",
  "widgetState": "IN_PROGRESS",
  "fiatCurrency": "text",
  "fiatAmount": 1,
  "description": "text",
  "logoUrl": "text",
  "returnUrl": "text",
  "supportUrl": "text",
  "expiration": "2025-12-08T08:36:26.584Z",
  "externalId": "text",
  "invoices": [
    {
      "invoiceId": "text",
      "cryptoCurrency": "text",
      "invoiceIdempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
      "invoiceExternalId": "text"
    }
  ],
  "createdDate": "2025-12-08T08:36:26.584Z"
}

Create new Single Fiat Payment widget

post

Permission annotations:

Header parameters

KeystringRequired

SignstringRequired

Body

application/json

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

*/*

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/payment-widget/single-fiat/create

HTTPcURLJavaScriptPython

POST /api/v1/payment-widget/single-fiat/create HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 302

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "fiatCurrency": "text",
    "fiatAmount": 1,
    "description": "text",
    "cryptoCurrencies": [
      "text"
    ],
    "logoUrl": "text",
    "returnUrl": "text",
    "supportUrl": "text",
    "expiration": "2025-12-08T08:36:26.584Z",
    "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
    "externalId": "text"
  }
}

{
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
  "cryptoCurrencies": [
    "text"
  ],
  "widgetType": "SINGLE_FIAT",
  "widgetState": "IN_PROGRESS",
  "fiatCurrency": "text",
  "fiatAmount": 1,
  "description": "text",
  "logoUrl": "text",
  "returnUrl": "text",
  "supportUrl": "text",
  "expiration": "2025-12-08T08:36:26.584Z",
  "externalId": "text",
  "invoices": [
    {
      "invoiceId": "text",
      "cryptoCurrency": "text",
      "invoiceIdempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
      "invoiceExternalId": "text"
    }
  ],
  "createdDate": "2025-12-08T08:36:26.584Z"
}

Archive Single Fiat Payment widget by ID

post

Permission annotations:

Header parameters

KeystringRequired

SignstringRequired

Body

application/json

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

*/*

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/payment-widget/single-fiat/archive

HTTPcURLJavaScriptPython

POST /api/v1/payment-widget/single-fiat/archive HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 95

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "requestId": "123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
  "cryptoCurrencies": [
    "text"
  ],
  "widgetType": "SINGLE_FIAT",
  "widgetState": "IN_PROGRESS",
  "fiatCurrency": "text",
  "fiatAmount": 1,
  "description": "text",
  "logoUrl": "text",
  "returnUrl": "text",
  "supportUrl": "text",
  "expiration": "2025-12-08T08:36:26.584Z",
  "externalId": "text",
  "invoices": [
    {
      "invoiceId": "text",
      "cryptoCurrency": "text",
      "invoiceIdempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
      "invoiceExternalId": "text"
    }
  ],
  "createdDate": "2025-12-08T08:36:26.584Z"
}

Get all Single Fiat Payment widgets

post

Permission annotations:

Header parameters

KeystringRequired

SignstringRequired

Body

application/json

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

*/*

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/payment-widget/single-fiat/all

HTTPcURLJavaScriptPython

POST /api/v1/payment-widget/single-fiat/all HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 100

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "widgetStates": [
      "IN_PROGRESS"
    ],
    "pageNumber": 1,
    "size": 10
  }
}

{
  "result": [
    {
      "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
      "cryptoCurrencies": [
        "text"
      ],
      "widgetType": "SINGLE_FIAT",
      "widgetState": "IN_PROGRESS",
      "fiatCurrency": "text",
      "fiatAmount": 1,
      "description": "text",
      "logoUrl": "text",
      "returnUrl": "text",
      "supportUrl": "text",
      "expiration": "2025-12-08T08:36:26.584Z",
      "externalId": "text",
      "invoices": [
        {
          "invoiceId": "text",
          "cryptoCurrency": "text",
          "invoiceIdempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
          "invoiceExternalId": "text"
        }
      ],
      "createdDate": "2025-12-08T08:36:26.584Z"
    }
  ],
  "page": 1,
  "size": 1,
  "total": 1,
  "totalElements": 1
}