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
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

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

Request 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]
    }
}'

Responses

🟢200成功

application/json

Body

header

object

required

success

boolean

required

result

object

required

integer

required

currency

string

required

amount

string

required

type

string

required

status

string

required

remitInfoId

integer

required

referenceNo

string

required

customerRemark

string

required

createdTime

string

required

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-06-11 13:50:23

Get Balance

Create Fiat Withdraw