Create Fiat Deposit

Sandbox

https://wallet.test.wspn.io

POST

/openapi/v1/fiat-transaction/deposit

API to create a fiat deposit transaction record and provide the corresponding
bank transfer record number.
After receiving the bank transfer, a notification will be sent to the user.

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	Deposit amount, decimal scale: 2, JPY: 0
referenceNo	String	Y	255	Bank transfer record number , not required if greenLinkVA is Yes
customerRemark	String	N	255	Remark
remitInfoId	Number	Y	2^63 - 1	currency of the remit bank account must be the same Currency;3.2.1 Get Deposit Remit Info Return
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.
fileIdList	Array	Y	2	The fileId returned by the File Upload interface, not required if greenLinkVA is Yes
greenLinkVA	String	N	3	Null or Yes or No, default Null

Example:{ "query": { "requestId":"af515a-4729-4b7b-v2d1a-b146dbc21", "currency": "USD", "amount": "1", "remitInfoId": 1, "referenceNo": "customer bank transfer NO.", "customerRemark": "customerRemark", "fileIdList": [1786,1787], "greenLinkVA": "No" } }

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://wallet.test.wspn.io/openapi/v1/fiat-transaction/deposit' \
--header 'Content-Type: text/plain' \
--data-raw '{
    "query": {
        "requestId":"af515a-4729-4b7b-v2d1a-b146dbc21", 
        "currency": "USD",
        "amount": "1",
        "remitInfoId": 1,   
        "referenceNo": "customer bank transfer NO.", 
        "customerRemark": "customerRemark",
        "fileIdList": [1786,1787],
        "greenLinkVA": "No"
    }
}'

Responses

🟢200成功

application/json

Body

Example

{
    "header": {
        "success": true
    },
    "result": {
        "id": 250103134318531,
        "currency": "USD",
        "amount": "1.00",
        "type": "DEPOSIT",
        "status": "TO_BE_CONFIRMED",
        "remitInfoId": 1,
        "referenceNo": "customer bank transfer NO.",
        "customerRemark": "customerRemark",
        "createdTime": "2025-01-03 13:43:18"
    }
}

Modified at 2025-07-02 02:32:18

Get Balance

Create Fiat Withdraw