🔒Add payment details

In case you'd like to spin off your own UI, this endpoint allows you to submit the details from the end-user for the initiated deposit request. The end-user will be required to choose a depositCurrency.

Submit crypto payment

If you are using our payment URL supplied as a response of "Request payment" request, you'll not need to run this request. It will be handled by our hosted checkout application.

patch

/api/v1/payments/{paymentId}

Authorizations

Path parameters

paymentIdstring · uuidrequired

ID of the payment to submit.

Body

displayAmountstring

Amount in displayCurrency, if not provided on payment creation.

depositCurrencystring · enumrequired

Cryptocurrency that should be used for the deposit.

Options: BCH, BTC, ETH, LINK, LTC, SOL, USDC, XLM, XRP

networkstring · enum

Cryptocurrency network on which the deposit will be received. Defaults to the native network for depositCurrency.

Options: BCH, BTC, LTC, XLM, XRP, ETH, BSC, SOL, TRX

displayCurrencystring · enum

Fiat currency, if not provided on payment creation.

Options: AED, ARS, AUD, BDT, BGN, BRL, CAD, CHF, CLP, CNY, CZK, DKK, EUR, GBP, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KES, KRW, MXN, MYR, NGN, NOK, NZD, PEN, PHP, PLN, QAR, RON, RUB, SEK, SGD, THB, TRY, USD, VND, ZAR

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url '/api/v1/payments/{paymentId}' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "displayCurrency": "EUR",
    "displayAmount": 50,
    "depositCurrency": "USDC",
    "network": "ETH"
  }'

200

200

{
  "paymentInfo": {
    "paymentId": "2fcd3399-49d4-45e0-b995-7c489f43fe08",
    "clientPaymentId": "test-payment-23-12-18-1",
    "businessId": "407710f4-de33-454b-a47f-dda792e272c8",
    "locale": "en-US",
    "status": "PENDING",
    "rateType": "FLOATING",
    "type": "ONE_TIME",
    "url": "https://example.com/deposit/2fcd3399-49d4-45e0-b995-7c489f43fe08?theme=skilling&locale=en-US&sessionToken=eyJhbGciOiJIUzUxMiJ9.eyJidXNpbmVzc0lkIjoiNDA3NzEwZjQtZGUzMy00NTRiLWE0N2YtZGRhNzkyZTI3MmM4Iiwib3JnYW5pc2F0aW9uSWQiOiJjZjFlNjdkMC00NmY2LTRhMDAtODM3MC0wOTBhNTA4N2M4MGYiLCJpYXQiOjE3MDI5MDY4OTksInBheW1lbnRJZCI6IjJmY2QzMzk5LTQ5ZDQtNDVlMC1iOTk1LTdjNDg5ZjQzZmUwOCJ9.LUnvFdCySVS03SX2ym4eJdUDlQfTe2un_DZ3tbYAoc7c9ABj71Po43tVxLTGP7VknrSftjB5ItvEuxF9EGn84Q",
    "overpaymentPolicy": "PROCESS",
    "refundFollowUpDepositsForOneTimePayments": false,
    "processorType": "BLOCKCHAIN",
    "walletAddress": "0x356c19d41921eb88C03308F31700C3F08cbD36D4",
    "displayCurrency": "EUR",
    "expectedDisplayAmount": "50.00",
    "expectedDisplayDistributedUserServiceFee": "0.00",
    "actualDisplayAmount": "0.00",
    "actualDisplayDistributedUserServiceFee": "0.00",
    "depositCurrency": "USDC",
    "expectedNetwork": "ETH",
    "expectedDepositAmount": "54.759355",
    "expectedDepositDistributedUserServiceFee": "0.000000",
    "actualDepositAmount": "0",
    "actualDepositDistributedUserServiceFee": "0",
    "expectedUniformAmount": "50.00",
    "actualUniformAmount": "0.00",
    "userServiceFeeDistributionPercentage": "0.00",
    "redirectUrl": "https://my-business.com/account?id=3423",
    "expirationMinutes": 10080,
    "paymentRequestedAt": 1702909646,
    "paymentInitiatedAt": 1702906899,
    "deposits": []
  }
}

Returns the submitted payment.