换汇预下单(询价) - PayKKa OpenAPI Documentation

请求参数

Header 参数

X-Merch-Id

string

可选

默认值:

M24061911365700670

Body 参数application/json

sell_currency

enum<string>

必需

卖出币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元, SGD-新加坡元, HKD-港币, PHP-菲律宾比索, CNH-离岸人民币

枚举值:

EURUSDCNYGBPJPYAUDCADSGDHKDPHPCNH

buy_currency

enum<string>

必需

买入币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元, SGD-新加坡元, HKD-港币, PHP-菲律宾比索, CNH-离岸人民币

枚举值:

EURUSDCNYGBPJPYAUDCADSGDHKDPHPCNH

sell_amount

integer

可选

卖出金额(币种最小单位)，sell_amount和buy_amount必传其中一个

buy_amount

integer

可选

买入金额(币种最小单位)，sell_amount和buy_amount必传其中一个

示例

{
    "sell_currency": "EUR",
    "buy_currency": "EUR",
    "sell_amount": 0,
    "buy_amount": 0
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://open-fat.cb.paykka.com/api/v2/fx/conversion/preorder' \
--header 'X-Merch-Id: M24061911365700670' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sell_currency": "EUR",
    "buy_currency": "EUR",
    "sell_amount": 0,
    "buy_amount": 0
}'

返回响应

🟢200成功

application/json

Body

order_no

string

换汇订单号

必需

sell_currency

string

卖出币种

必需

buy_currency

string

买入币种

必需

sell_amount

integer

必需

卖出金额(币种最小单位)

buy_amount

integer

必需

买入金额(币种最小单位)

fx_rate

number

必需

汇率(1单位卖出货币兑换多少单位买入货币)

expire_at

string <date-time>

必需

过期于(format: yyyy-MM-dd'T'HH:mm:ssXXX)

示例值:

2024-12-03T23:33:33Z

示例

{
    "order_no": "string",
    "sell_currency": "string",
    "buy_currency": "string",
    "sell_amount": 0,
    "buy_amount": 0,
    "fx_rate": 0,
    "expire_at": "2024-12-03T23:33:33Z"
}