- Introduction
- Get Started
- Signature
- What is WUSD
- Webhook Service
- Sandbox Environment
- Blockchain Confirmations
- Appendix
- API Keys
- Core Functionality
- Api Reference
- Authentication
- Wallet
- Address
- Remit Info
- Transaction
Create Fiat Withdraw
Developing
POST
/openapi/v1/fiat-transaction/withdraw
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).
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 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
header
object
required
success
boolean
required
result
object
required
id
integer
required
currency
string
required
amount
string
required
type
string
required
status
string
required
transactionFee
string
required
remitInfoId
integer
required
referenceNo
string
required
purpose
string
required
createdTime
string
required
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"
}
}