Finrax API Documentation
DashboardResourcesMain
  • Introduction
  • Authorization
    • API Keys Management
    • Signature
    • Code snippets
  • Environments
  • Errors
  • Changelog
  • References
    • Crypto payments
      • 馃敀Request crypto payment
      • 馃敀Add payment details
      • 馃敀Get payment data
      • Fetch deposit amounts metadata
    • Crypto withdrawals
      • Request withdrawal metadata
      • 馃敁Get crypto withdrawal approval status
      • 馃敀Request crypto withdrawal
        • National Identifier Types
        • Name Identifier Type
    • Wallet Addresses
      • Validate address
    • Businesses
      • 馃敀Get business payments
      • 馃敀Get business withdrawals
      • 馃敀Get business balances
    • Callbacks
      • Deposit received notification
      • Withdrawal broadcast notification
      • Withdrawal approved/rejected notification
    • Currencies & Fees
      • Get all currencies
      • Get exchange rates [crypto to fiat]
      • Get exchange rates [fiat to fiat]
      • Get exchange rates [any currency to any currency]
Powered by GitBook
On this page

Was this helpful?

  1. References
  2. Crypto payments

Request crypto payment

This is an authenticated endpoint

PreviousCrypto paymentsNextAdd payment details

Last updated 1 month ago

Was this helpful?

Initiate a payment request

More information regarding FIXED/FLOATING rate types

More information on ONE_TIME/REUSABLE payment links

馃敀
here
here
  • Initiate a payment request
  • POSTRequest crypto payment

Request crypto payment

post

An endpoint for initiating a crypto payment request. Upon success, a unique paymentUrl is provided in the response which can be served within an iframe.

Alternatively, you can redirect to the payment URL and if you have supplied a redirectUrl in the request, we will navigate the end-user back to your website upon payment completion (when we have received a deposit against this payment request). There is also a button which the end-user can use if they wish to get redirected back sooner.

Authorizations
Body
clientPaymentIdstringRequired

Payment identifier provided in the request.

businessIdstring 路 uuidRequired
typestring 路 enumOptionalPossible values:
displayCurrencystring 路 enumOptional

Fiat currency. You should provide this or depositCurrency.

Possible values:
displayAmountstringOptional

Amount in displayCurrency that the user wants to deposit. Required if displayCurrency is provided.

depositCurrencystring 路 enumOptional

Cryptocurrency. You should provide this or displayCurrency.

Possible values:
depositAmountstringOptional

Amount in depositCurrency that the user wants to deposit. Required if depositCurrency is provided.

networkstring 路 enumOptional

Cryptocurrency network. Required if depositCurrency is provided.

Possible values:
rateTypestring 路 enumOptional
  • ONE_TIME payments: FIXED or FLOATING.
  • REUSABLE payments: You can omit this parameter. Reusable payments are set to FLOATING.
Possible values:
expirationMinutesinteger 路 int64Optional
  • ONE_TIME payments: Indicates the timeframe in which the deposit should happen. A value of 0 will set the payment expiry to 7 days. Defaults to 30 min.
  • REUSABLE payments: You can omit this parameter. Reusable payments are set to non-expiry.
localestringRequired

IETF BCP 47 language tag, e.g. 'en-US', 'fr-FR'. Alternatively, the locale string can be submitted with an '_' instead of '-', e.g. 'en_US' or 'fr_FR' or as an ISO 639-1 language code, e.g. 'en' or 'fr'. Supported languages:

  • Arabic (ar)
  • Bulgarian (bg)
  • Chinese (zh)
  • English (en)
  • French (fr)
  • German (de)
  • Japanese (ja)
  • Lithuanian (lt)
  • Portuguese (pt)
  • Russian (ru)
  • Spanish (es)
  • Turkish (tr)
redirectUrlstringOptional

Custom URL where the user will be redirected after payment completion.

redirectModestring 路 enumOptional

Specifies how to open the redirect URL

  • PARENT (default): Opens the redirect URL in the parent browsing context. Refers to HTML anchor target attribute value _top.
  • SELF: Opens the redirect URL in the current browsing context. Refers to HTML anchor target attribute value _self.
Possible values:
Responses
200
Returns the created payment.
application/json
post
POST /api/v1/payments HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 276

{
  "clientPaymentId": "test-payment-15-09-23-1",
  "locale": "en-US",
  "type": "ONE_TIME",
  "displayCurrency": "EUR",
  "displayAmount": 50,
  "rateType": "FIXED",
  "expirationMinutes": 10080,
  "businessId": "407710f4-de33-454b-a47f-dda792e272c8",
  "redirectUrl": "https://my-business.com/account?id=3423"
}
200

Returns the created payment.

{
  "paymentInfo": {
    "paymentId": "2fcd3399-49d4-45e0-b995-7c489f43fe08",
    "clientPaymentId": "test-payment-15-09-23-1",
    "businessId": "407710f4-de33-454b-a47f-dda792e272c8",
    "locale": "en-US",
    "status": "NEW",
    "rateType": "FIXED",
    "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",
    "displayCurrency": "EUR",
    "expectedDisplayAmount": "50.00",
    "actualDisplayAmount": "0.00",
    "actualDisplayDistributedUserServiceFee": "0.00",
    "actualDepositAmount": "0",
    "actualDepositDistributedUserServiceFee": "0",
    "actualUniformAmount": "0.00",
    "userServiceFeeDistributionPercentage": "0.00",
    "redirectUrl": "https://my-business.com/account?id=3423",
    "expirationMinutes": 10080,
    "initiatedBy": "john.doe@gmail.com",
    "paymentInitiatedAt": 1702906899,
    "deposits": []
  },
  "paymentUrl": "https://example.com/deposit/2fcd3399-49d4-45e0-b995-7c489f43fe08?theme=skilling&locale=en-US&sessionToken=eyJhbGciOiJIUzUxMiJ9.eyJidXNpbmVzc0lkIjoiNDA3NzEwZjQtZGUzMy00NTRiLWE0N2YtZGRhNzkyZTI3MmM4Iiwib3JnYW5pc2F0aW9uSWQiOiJjZjFlNjdkMC00NmY2LTRhMDAtODM3MC0wOTBhNTA4N2M4MGYiLCJpYXQiOjE3MDI5MDY4OTksInBheW1lbnRJZCI6IjJmY2QzMzk5LTQ5ZDQtNDVlMC1iOTk1LTdjNDg5ZjQzZmUwOCJ9.LUnvFdCySVS03SX2ym4eJdUDlQfTe2un_DZ3tbYAoc7c9ABj71Po43tVxLTGP7VknrSftjB5ItvEuxF9EGn84Q"
}