API to create fiat withdraw transaction record. Will initiate a transfer of all the user's balance to the designated bank account and notify the user once the transaction is completed. Before creating the transaction, the corresponding fiat withdrawal bank account must be added(3.2.2 Add Remit Info). Note: The minimum withdrawal amount is 100.
Request
Body Params text/plain
Example
Field
Type
Required
Max Length
Description
query
Object
Y
currency
String
Y
currency of the remit bank account must be the same Currency
amount
String
Y
20
withdraw currency account all balance, decimal scale: 2, JPY: 0
remitInfoId
Number
Y
2^63 - 1
From Get Remit Info Api Result Id
referenceNo
String
N
255
This will be shown in your bank statement for reconciliation
purpose
String
N
255
purpose of Transfer
requestId
String
Y
64
A unique identifier for the request. If the same request is sent again with the same requestId, it will be rejected to prevent duplicate processing.
Example:{
"query": {
"currency": "USD",
"amount": "1",
"remitInfoId": 1205,
"referenceNo": "This will be shown in your bank statement for reconciliation",
"purpose": "purpose of Transfer",
"requestId": "af5152a-4719-4b17b-v218a-b111bc21"
}
}
Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl--location--request POST 'https://wallet.test.wspn.io/openapi/v1/fiat-transaction/withdraw' \
--header'Content-Type: text/plain' \
--data-raw'{
"query": {
"currency": "USD",
"amount": "1",
"remitInfoId": 1205,
"referenceNo": "This will be shown in your bank statement for reconciliation",
"purpose": "purpose of Transfer",
"requestId": "af5152a-4719-4b17b-v218a-b111bc21"
}
}'
Responses
🟢200成功
application/json
Body
Example
{"header":{"success":true},"result":{"id":250103163226537,"currency":"USD","amount":"1000.00","type":"WITHDRAW","status":"TO_BE_PROCESSED","transactionFee":"0.00","remitInfoId":1216,"referenceNo":"623058099345455","purpose":"purpose of Transfer","createdTime":"2025-01-03 16:32:26"}}