Skip to main content
POST
/
v1
/
payments
Create a payment
curl --request POST \
  --url https://api-sandbox.superbank.com/v1/payments \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "type": "LIQUIDITY",
  "amount": 100,
  "currencyCode": "USDC",
  "chain": "SOLANA",
  "destinationWallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "accountHolder": {
    "type": "INDIVIDUAL",
    "address": {
      "countryCode": "US"
    },
    "firstName": "John",
    "lastName": "Doe",
    "businessName": "Acme Corp"
  },
  "metadata": {
    "orderId": "order-123",
    "customerId": "cust-456"
  }
}
'
{}

Authorizations

​
X-Api-Key
string
header
required

Body

application/json
​
type
enum<string>
required

Payment type. Only LIQUIDITY is currently supported.

Available options:
LIQUIDITY
Example:

"LIQUIDITY"

​
amount
number
required

Payment amount in the source currency

Required range: x >= 0.01
Example:

100

​
currencyCode
enum<string>
required

Currency code for the payment. Only USDC is currently supported.

Available options:
USDC
Example:

"USDC"

​
chain
enum<string>
required

Blockchain network for the transfer. Only SOLANA is currently supported.

Available options:
SOLANA
Example:

"SOLANA"

​
destinationWallet
string
required

Destination wallet address to receive the stablecoins

Example:

"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"

​
accountHolder
object

Account holder information. Required when destination wallet is not already registered in the system.

​
metadata
object

Custom metadata to attach to the payment for your reference

Example:
{
  "orderId": "order-123",
  "customerId": "cust-456"
}

Response

Payment created successfully

The response is of type object.