1. Orders
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Balances & Transaction History
        • Get Balances
        • Get Transaction History
        • Create Wallet
      • Currency Exchange
        • Retrieve Exchange Rate
        • Retrieve Exchange Rate and Create a Lock
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
      • SEPA Transfers
        • Get SEPA Deposit Info
        • Get SEPA Deposit Contact List
        • Create a SEPA Transfer
        • Get SEPA Transfer Details
      • Crypto Withdrawal
        • Get Network Fee
        • Create Crypto Withdrawal
        • Get Crypto Withdrawal Details
      • Crypto Deposits
        • Update Travel Rule
      • Orders
        • Get Rates
          GET
        • Retrieve Order Rate and Create a Lock
          POST
        • Create and Finalize an Order
          POST
        • Get Order Details
          GET
      • Payment link & Checkout Link
        • Generate Payment Link
        • Generate Hosted Checkout
        • Get Payment Link Details
    • User Operations
      • Onboarding & KYC Flow
        • Create User Account
        • Method A: Add KYC File
        • Method B: Creating KYC Verification
        • Method B: Redirect to Verification
        • Method B: Get KYC Status
        • Add User Verification
        • Add POA File
      • Account Management
        • Update Existing User
        • Delete User
        • Suspend User
        • Unsuspend User
      • Balances & Transaction History
        • Get User Balances
        • Get User Transaction History
      • Currency Exchange
        • Retrieve Exchange Rate
        • Retrieve Exchange Rate and Create a Lock
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
      • SEPA Transfers
        • Get SEPA Deposit Info
        • GET SEPA Deposit Contact List
        • Create a SEPA Transfer
        • Get SEPA Transfer Details
      • Crypto Withdrawal
        • Get Network Fee
        • Create Crypto Withdrawal
        • Get Crypto Withdrawal Details
      • Crypto Deposits
        • Update Travel Rule
      • Internal Transfers
        • Create a Transfer
        • Get Transfer Details
      • Virtual Cards
        • Create Virtual Card
        • Get All User Cards
        • Get Card Details
        • Update Card PIN
        • Block Card
        • Unblock Card
        • Get Card Limits
        • Update Card Limits
        • Delete Card
  • Integration
    • SDKs & Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • User & KYC Webhooks
        • User Balance Generation Webhook
        • KYC File Added Webhook
        • POA Verification Status Webhook
        • KYC Verification Status Webhook
        • Create Wallet Webhook
        • High Risk KYC Verification Webhook
      • Transfers & Payments Webhooks
        • Internal Transfer Webhook
        • IBAN Status Webhook
        • Partner SEPA Transfer Webhook
        • User SEPA Transfer Webhook
        • SEPA Deposit Webhook
        • Crypto Withdrawal Webhook
        • Crypto Deposit Webhook
        • Exchange Webhook
        • Card Transaction Webhook
        • Order Status Webhook
        • Payment Link Webhook
      • Card Webhooks
        • Card 3DS Code Webhook
        • Card Activation Code Webhook
  • Reference
    • Supported Countries
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. Orders

Create and Finalize an Order

Testing Env
https://stage-api.fintegence.io
Testing Env
https://stage-api.fintegence.io
POST
/v1/order
Creates an order from a previously locked exchange rate (lockId) and initiates the transaction process.
After payment is received and the order is executed, the received funds are automatically converted into the specified settlement currency.
Asynchronous Wallet Creation
The key feature of this endpoint is that wallet creation is asynchronous. Full order details, such as the payment wallet address, are not available immediately after order creation.

How It Works#

1.
You send a valid lockId in the request.
2.
The API returns an immediate response containing a unique orderId, confirming the order has been accepted.
3.
In the background, the system starts generating a wallet. During this period, order status is WAITING_FOR_WALLET_ADDRESS.
4.
While wallet generation is in progress, calling Get Order Details returns WAITING_FOR_WALLET_ADDRESS, and walletAddress is null.
5.
As soon as the wallet is ready, a webhook is sent to your configured URL with complete order details (including wallet address) and updated status.
6.
After payment is confirmed on the generated wallet address, the order is executed, and the cryptocurrency is automatically converted into the target settlement currency according to the locked rate.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Body Params application/json

Examples

Responses

🟢201Created
application/json
Bodyapplication/json

🟠400P403: Validation error
🟠400P500: Unknown exception
🟠400P501: Service temporarily unavailable
🟠401Access Denied
🟠404P462: Invalid order lock
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://stage-api.fintegence.io/v1/order' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "lockId": "36e19a53-a1b4-499c-99f7-b7bfc6be87e4"
}'
Response Response Example
201 - Success
{
    "orderId": "663318af-7ea1-4c5a-8545-e433a2d43d5c"
}
Previous
Retrieve Order Rate and Create a Lock
Next
Get Order Details
Built with