v2.1 vs v2.0

统计概览

状态	数量
新增API	2
删除API	3
修改API	70
无变化	0

修改的API详情

Buyer Status Webhook

路径: /
方法: POST

响应体变更:

signature (删除)

类型: string

必填: True

描述: Webhook signature

timestamp (删除)

类型: integer

必填: True

描述: Webhook timestamp

webhookData

updateAt (删除)

类型: integer

必填: True

描述: Update timestamp, UNIX timestamp in milliseconds (e.g., 1715000000000)

updatedAt (新增)

类型: integer

必填: True

描述: Update timestamp, UNIX timestamp in milliseconds (e.g., 1715000000000)

status

描述变更:
旧: Indicates the current status of the application.
新: Indicates the current status of the application. Enum values: - 1: SCREENING PASSED - 2: SCREENING FAILED

Upload File

路径: /v2.0/auth/tools/upload
方法: POST

响应体变更:

fileId (删除)

类型: string

必填: False

描述: The unique id of the uploaded file

fileSize (删除)

类型: integer

必填: False

描述: The size of the uploaded file (byte)

code (新增)

类型: string

必填: True

描述: Response Code

data (新增)

类型: object

必填: True

msg (新增)

类型: string

必填: False

描述: Response Message

Add Bank Account

路径: /v1.0/crm/addressBook/addBankAccount → /v2.0/crm/addressBook/addBankAccount
方法: POST

Get Bank Accounts

路径: /v1.0/crm/addressBook/bankAccount → /v2.0/crm/addressBook/bankAccount
方法: GET

Create Buyer

路径: /v1.0/crm/addressBook/createBuyer → /v2.0/crm/addressBook/createBuyer
方法: POST

响应体变更:

data

createdAt

描述变更:
旧: Timestamp of creation, UNIX timestamp in milliseconds (e.g., 1715000000000)
新: Timestamp of creation, UNIX timestamp in milliseconds (e.g., 1715000000000) (Unix timestamp in milliseconds)

Create Merchant

路径: /v2.0/crm/addressBook/createMerchant
方法: POST

请求体变更:

merchantDetails

additionalPersonalDetails

sourceOfWealth

必填: False -> True

描述变更:
旧: Source of wealth (If HIGH risk and/or PEP)
新: Source of wealth

personalDetails

contactNumber

描述变更:
旧:
新: Phone number for contact, country code + Number. eg, +65 87654321

dateOfBirth

描述变更:
旧: Date of birth (UTC format)
新: Date of birth, format: YYYY-MM-DD, e.g., 1990-05-15

taxResidency

描述变更:
旧:
新: The country of tax residency (Country Code in ISO 3166-1 alpha-2 format)

corporationDetails

dateOfIncorporation

描述变更:
旧: Date of Incoporation
新: Date of Incoporation, format: YYYY-MM-DD, e.g., 1990-05-15

响应体变更:

data

createdAt

merchantInfo

merchantDetails

additionalPersonalDetails

sourceOfWealth

必填: False -> True

描述变更:
旧: Source of wealth (If HIGH risk and/or PEP)
新: Source of wealth

personalDetails

contactNumber

描述变更:
旧:
新: Phone number for contact, country code + Number. eg, +65 87654321

dateOfBirth

描述变更:
旧: Date of birth (UTC format)
新: Date of birth, format: YYYY-MM-DD, e.g., 1990-05-15

taxResidency

描述变更:
旧:
新: The country of tax residency (Country Code in ISO 3166-1 alpha-2 format)

corporationDetails

dateOfIncorporation

描述变更:
旧: Date of Incoporation
新: Date of Incoporation, format: YYYY-MM-DD, e.g., 1990-05-15

status

描述变更:
旧: Current status of the application
新: Current status of the application Enum values: - 1: PROCESSING - 2: APPROVED - 3: REJECTED

Get Merchant

路径: /v2.0/crm/addressBook/getMerchant
方法: GET

响应体变更:

data

merchantInfo

merchantDetails

additionalPersonalDetails

sourceOfWealth

必填: False -> True

描述变更:
旧: Source of wealth (If HIGH risk and/or PEP)
新: Source of wealth

personalDetails

contactNumber

描述变更:
旧:
新: Phone number for contact, country code + Number. eg, +65 87654321

dateOfBirth

描述变更:
旧: Date of birth (UTC format)
新: Date of birth, format: YYYY-MM-DD, e.g., 1990-05-15

taxResidency

描述变更:
旧:
新: The country of tax residency (Country Code in ISO 3166-1 alpha-2 format)

corporationDetails

dateOfIncorporation

描述变更:
旧: Date of Incoporation
新: Date of Incoporation, format: YYYY-MM-DD, e.g., 1990-05-15

merchantStatus

描述变更:
旧: Merchant status
新: Merchant status Enum values: - 1: PROCESSING - 2: APPROVED - 3: REJECTED

Get Deposit Bank Account

路径: /v1.0/crm/deposit/bankAccount → /v2.0/crm/deposit/bankAccount
方法: GET

Create Collection Wallet

路径: /v1.0/crm/deposit/createWallet → /v2.0/crm/deposit/createWallet
方法: POST

请求体变更:

expiry

描述变更:
旧: Expiry of the wallet address, UNIX timestamp (milliseconds) If fill in 0, it means that the wallet will no expire
新: Expiry of the wallet address, UNIX timestamp (milliseconds) If fill in 0, it means that the wallet will no expire (Unix timestamp in milliseconds)

响应体变更:

data

createAt (删除)

类型: string

必填: True

描述: Timestamp of creation (UTC Time Format eg. 2024-12-09T08:08:11.000+00:00)

createdAt (新增)

类型: integer

必填: True

描述: Timestamp of creation (UTC Time Format eg. 2024-12-09T08:08:11.000+00:00) (Unix timestamp in milliseconds)

Get Collection Wallet

路径: /v1.0/crm/deposit/getWallet → /v2.0/crm/deposit/getWallet
方法: GET

Update Collection Wallet

路径: /v1.0/crm/deposit/updateWallet → /v2.0/crm/deposit/updateWallet
方法: POST

请求体变更:

expiry

描述变更:
旧: Expiry of the wallet address, UNIX timestamp (milliseconds)
新: Expiry of the wallet address, UNIX timestamp (milliseconds) (Unix timestamp in milliseconds)

status

描述变更:
旧: Wallet status, only INACTIVE is allowed in MVP
新: Wallet status, only INACTIVE is allowed in MVP Enum values: - 1: ACTIVE - 2: INACTIVE

响应体变更:

data

updateAt (删除)

类型: integer

必填: True

描述: Timestamp of the wallet status being updated, UNIX timestamp in milliseconds (e.g., 1715000000000)

updatedAt (新增)

类型: integer

必填: True

描述: Timestamp of the wallet status being updated, UNIX timestamp in milliseconds (e.g., 1715000000000)

Get Crypto Deposit Wallet

路径: /v1.0/crm/deposit/wallet → /v2.0/crm/deposit/wallet
方法: GET

Submit Additional Information for Fiat Account Request

路径: /v2.0/crm/fiatAccount/addInfo/submit
方法: POST

响应体变更:

data

createdAt

status

描述变更:
旧: Status of the request
新: Status of the request Enum values: - 1: PENDING - 2: PROCESSING - 3: ACTIVE - 4: REJECTED

updatedAt

描述变更:
旧: Timestamp of update, UNIX timestamp in milliseconds (e.g., 1715000000000)
新: Timestamp of update, UNIX timestamp in milliseconds (e.g., 1715000000000) (Unix timestamp in milliseconds)

Get Fiat Account Application Status

路径: /v2.0/crm/fiatAccount/appStatus
方法: GET

响应体变更:

data

createdAt

status

描述变更:
旧: Status of the request
新: Status of the request Enum values: - 1: PENDING - 2: PROCESSING - 3: ACTIVE - 4: REJECTED

updatedAt

Get Balance

路径: /v1.0/ledger/account → /v2.0/ledger/account
方法: GET

Create Token

路径: /v1.0/oauth/token → /v2.0/oauth/token
方法: POST

摘要变更:

旧: Get Token

新: Create Token

请求体变更:

client_id (删除)

类型: string

必填: True

描述: Client's ID

client_secret (删除)

类型: string

必填: True

描述: Client's Secret

clientId (新增)

类型: string

必填: True

描述: Client's ID

clientSecret (新增)

类型: string

必填: True

描述: Client's Secret

响应体变更:

access_token (删除)

类型: string

必填: False

描述: Access token

expires_in (删除)

类型: integer

必填: False

描述: Token expiry time

not-before-policy (删除)

类型: integer

必填: False

描述: A timestamp before which tokens are considered invalid

refresh_expires_in (删除)

类型: integer

必填: False

描述: Time in seconds until the token expiry is refreshed

scope (删除)

类型: string

必填: False

描述: Scope included in the token

token_type (删除)

类型: string

必填: False

描述: Token type

accessToken (新增)

类型: string

必填: False

描述: Access token

expiresIn (新增)

类型: integer

必填: False

描述: Token expiry time

tokenType (新增)

类型: string

必填: False

描述: Token type

Get Internal Transfer

路径: /v1.0/payment/account/getInternalTransfer → /v2.0/payment/account/getInternalTransfer
方法: GET

响应体变更:

data

createdAt

类型: string -> integer

描述变更:
旧: Transfer transaction time
新: Transfer transaction time (Unix timestamp in milliseconds)

Internal Transfer

路径: /v1.0/payment/account/internalTransfer → /v2.0/payment/account/internalTransfer
方法: POST

响应体变更:

data

createdAt

类型: string -> integer

描述变更:
旧: Transfer transaction time
新: Transfer transaction time (Unix timestamp in milliseconds)

Close Crypto Checkout

路径: /v1.0/payment/crypto/closeCryptoCheckout → /v2.0/payment/crypto/closeCryptoCheckout
方法: POST

响应体变更:

data (新增)

类型: null

必填: False

Confirm Crypto Refund

路径: /v1.0/payment/crypto/confirmCryptoRefund → /v2.0/payment/crypto/confirmCryptoRefund
方法: POST

响应体变更:

data

txnHash (删除)

类型: string

必填: False

描述: Transaction hash of the refund. Only available when status is COMPLETED

txHash (新增)

类型: string

必填: False

描述: Transaction hash of the refund. Only available when status is COMPLETED

Create Crypto Checkout

路径: /v1.0/payment/crypto/createCryptoCheckout → /v2.0/payment/crypto/createCryptoCheckout
方法: POST

请求体变更:

amountToPay

类型: number -> string

响应体变更:

data

conversions (新增)

类型: array

必填: False

receivedPayments (新增)

类型: array

必填: False

walletKyt (新增)

类型: object

必填: False

amountToPay

类型: integer -> string

expiry

描述变更:
旧: Timestamp for payment request expiry.
新: Timestamp for payment request expiry. (Unix timestamp in milliseconds)

status

描述变更:
旧: Current status of the crypto checkout
新: Current status of the crypto checkout Enum values: - 1: PENDING - 2: PAYMENT DETECTED - 3: PAYMENT ACCEPTED - 4: EXPIRED - 5: CLOSED - 6: WALLET SCREENING COMPLETED - 7: KYT COMPLETED - 8: CONVERSION INITIATED - 9: CONVERSION SETTLED

Create Crypto Checkout Link

路径: /v1.0/payment/crypto/createCryptoCheckoutLink → /v2.0/payment/crypto/createCryptoCheckoutLink
方法: POST

Create Crypto Refund

路径: /v1.0/payment/crypto/createCryptoRefund → /v2.0/payment/crypto/createCryptoRefund
方法: POST

响应体变更:

data

txnHash (删除)

类型: string

必填: False

描述: Transaction hash of the refund. Only available when status is COMPLETED

txHash (新增)

类型: string

必填: False

描述: Transaction hash of the refund. Only available when status is COMPLETED

Create Crypto Withdrawal

路径: /v1.0/payment/crypto/createCryptoWithdrawal → /v2.0/payment/crypto/createCryptoWithdrawal
方法: POST

请求体变更:

amount

类型: number -> string

响应体变更:

data

amount

类型: number -> string

beneficiaryWallet

ownerInfo

必填: False -> True

描述变更:
旧: required if "isOwner" is false
新: Owner information

platformUserId

描述变更:
旧: Platform user id
新: required if "walletType" is "Platform Wallet"

feeAmount

类型: number -> string

kytInfo

kytResult

描述变更:
旧: KYT result: 1-Passed, 2-Manual Review, 3-High Risk.
新: KYT result: 1-Passed, 2-Failed, 3-High Risk.

kytType

描述变更:
旧: kytType
新: KYT type. 1-Wallet Screening; 2-Transaction Screening

Crypto Checkout Wallet Connection

路径: /v1.0/payment/crypto/cryptoCheckoutWalletConnection → /v2.0/payment/crypto/cryptoCheckoutWalletConnection
方法: POST

响应体变更:

data (新增)

类型: null

必填: False

Get Convertible Cryptos

路径: /v1.0/payment/crypto/getConvertibleCryptos → /v2.0/payment/crypto/getConvertibleCryptos
方法: GET

Get Crypto Checkout

路径: /v1.0/payment/crypto/getCryptoCheckout → /v2.0/payment/crypto/getCryptoCheckout
方法: GET

响应体变更:

data

amountToPay

类型: number -> string

conversions

destinationAmount

描述变更:
旧: Amount of destination currency, sourceAmount or destinationAmount must fill one.
新: Amount of destination currency

receivedPayments

kytInfo

kytResult

描述变更:
旧: KYT result: 1-Passed, 2-Manual Review, 3-High Risk.
新: KYT result: 1-Passed, 2-Failed, 3-High Risk.

status

描述变更:
旧: Current status of the crypto checkout
新: Current status of the crypto checkout 1 PENDING 2 PAYMENT DETECTED 3 PAYMENT ACCEPTED 4 EXPIRED 5 CLOSED 6 WALLET SCREENING COMPLETED 7 KYT COMPLETED 8 CONVERSION INITIATED 9 CONVERSION SETTLED

walletKyt

kytResult

描述变更:
旧: KYT result: 1-Passed, 2-Manual Review, 3-High Risk.
新: KYT result: 1-Passed, 2-Failed, 3-High Risk.

Get Crypto Checkout Currencies

路径: /v1.0/payment/crypto/getCryptoCheckoutCurrencies → /v2.0/payment/crypto/getCryptoCheckoutCurrencies
方法: GET

Get Crypto Checkout Link

路径: /v1.0/payment/crypto/getCryptoCheckoutLink → /v2.0/payment/crypto/getCryptoCheckoutLink
方法: GET

Get Crypto Collection

路径: /v1.0/payment/crypto/getCryptoCollection → /v2.0/payment/crypto/getCryptoCollection
方法: GET

响应体变更:

data

amount

类型: number -> string

Get Crypto Refund

路径: /v1.0/payment/crypto/getCryptoRefund → /v2.0/payment/crypto/getCryptoRefund
方法: GET

响应体变更:

data

txnHash (删除)

类型: string

必填: False

描述: Transaction hash of the refund. Only available when status is COMPLETED

txHash (新增)

类型: string

必填: False

描述: Transaction hash of the refund. Only available when status is COMPLETED

Get Supported Blockchains

路径: /v1.0/payment/crypto/getSupportedBlockchains → /v2.0/payment/crypto/getSupportedBlockchains
方法: GET

Get Wallet Address

路径: /v1.0/payment/crypto/getWalletAddress → /v2.0/payment/crypto/getWalletAddress
方法: GET

响应体变更:

data

ownerInfo

必填: False -> True

描述变更:
旧: required if "isOwner" is false
新: Owner information

platformUserId

描述变更:
旧: Platform user id
新: required if "walletType" is "Platform Wallet"

Generate POS Payment Request

路径: /v1.0/payment/crypto/posPaymentRequest → /v2.0/payment/crypto/posPaymentRequest
方法: POST

响应体变更:

data

paymentAmount

类型: number -> string

Register Wallet Address

路径: /v1.0/payment/crypto/registerWalletAddress → /v2.0/payment/crypto/registerWalletAddress
方法: POST

请求体变更:

ownerInfo

必填: False -> True

描述变更:
旧: required if "isOwner" is false
新: Owner information

platformUserId

描述变更:
旧: Platform user id
新: required if "walletType" is "Platform Wallet"

响应体变更:

data

ownerInfo

必填: False -> True

描述变更:
旧: required if "isOwner" is false
新: Owner information

platformUserId

描述变更:
旧: Platform user id
新: required if "walletType" is "Platform Wallet"

Remove Wallet Address

路径: /v1.0/payment/crypto/removeWalletAddress → /v2.0/payment/crypto/removeWalletAddress
方法: POST

Update Co-KYT status

路径: /v1.0/payment/crypto/updateCoKytStatus → /v2.0/payment/crypto/updateCoKytStatus
方法: POST

请求体变更:

result

描述变更:
旧: Status of Co-KYT
新: Status of Co-KYT Enum values: - 1: PASSED - 2: FAILED

Update Crypto Deposit Travel Rule Info

路径: /v1.0/payment/crypto/updateCryptoDepositTravelRuleInfo → /v2.0/payment/crypto/updateCryptoDepositTravelRuleInfo
方法: POST

请求体变更:

ownerInfo

必填: False -> True

描述变更:
旧: required if "isOwner" is false
新: Owner information

platformUserId

描述变更:
旧: Platform user id
新: required if "walletType" is "Platform Wallet"

响应体变更:

data

类型: object -> null

必填: True -> False

Create Fiat Withdrawal

路径: /v2.0/payment/fiat/createWithdrawal
方法: POST

请求体变更:

amount

类型: number -> string

withdrawalType

描述变更:
旧: First or third party withdrawal
新: First or third party withdrawal Enum values: - 1: First Party - 2: Third Party

响应体变更:

data

amount

类型: number -> string

createdAt

estimatedAmountReceivable

类型: number -> string

fees

类型: number -> string

missingFields

描述变更:
旧: Missing fields for the withdrawal request. Ref. to {} for details
新: Missing fields

status

描述变更:
旧: Withdrawal status. Possible values: 1-PROCESSING, 2-COMPLETED, 3-CANCELLED, 4-FAILED, 5-PENDING.
新: Withdrawal status. Possible values: 1-PROCESSING, 2-COMPLETED, 3-CANCELLED, 4-FAILED, 5-PENDING. Enum values: - 1: PROCESSING - 2: COMPLETED - 3: CANCELLED - 4: FAILED - 5: PENDING

updatedAt

withdrawalType

描述变更:
旧: First or third party withdrawal
新: First or third party withdrawal Enum values: - 1: First Party - 2: Third Party

Get Fiat Deposit Detail

路径: /v1.0/payment/fiat/deposit/detail → /v2.0/payment/fiat/deposit/detail
方法: GET

响应体变更:

data

createdAt

类型: string -> integer

描述变更:
旧: Timestamp of deposit transaction, ISO-8601
新: Timestamp of deposit transaction (Unix timestamp in milliseconds)

Get Fiat Deposit History

路径: /v1.0/payment/fiat/deposit/history → /v2.0/payment/fiat/deposit/history
方法: GET

响应体变更:

data

endTime

描述变更:
旧:
新: Unix timestamp in milliseconds

startTime

描述变更:
旧:
新: Unix timestamp in milliseconds

transactions

createdAt

类型: string -> integer

描述变更:
旧: Timestamp of deposit transaction, ISO-8601
新: Timestamp of deposit transaction (Unix timestamp in milliseconds)

Get Fiat Withdrawal Detail

路径: /v2.0/payment/fiat/withdrawal/detail
方法: GET

响应体变更:

data

amount

类型: number -> string

createdAt

estimatedAmountReceivable

类型: number -> string

fees

类型: number -> string

status

描述变更:
旧: Status of the transaction. Possible values: 1-PROCESSING, 2-COMPLETED, 3-CANCELLED, 4-FAILED, 5-PENDING.
新: Withdrawal status. Possible values: 1-PROCESSING, 2-COMPLETED, 3-CANCELLED, 4-FAILED, 5-PENDING.

枚举值变更: 删除: [5]

swiftChargingCode

描述变更:
旧:
新: 1-BEN (Beneficiary Pays All Fees), 2-OUR (Sender Pays All Fees), 3-SHA (Shared Fees).

updatedAt

withdrawalType

描述变更:
旧: First or third party withdrawal
新: First or third party withdrawal Enum values: 1: First Party 2: Third Party

Get Fiat Withdrawal History

路径: /v2.0/payment/fiat/withdrawal/history
方法: GET

响应体变更:

data

endTime

描述变更:
旧: The end time
新: The end time (Unix timestamp in milliseconds)

startTime

描述变更:
旧: The start time
新: The start time (Unix timestamp in milliseconds)

transactions

amount

类型: number -> string

createdAt

estimatedAmountReceivable

类型: number -> string

fees

类型: number -> string

status

枚举值变更: 删除: [5]

swiftChargingCode

描述变更:
旧:
新: Swift charging code: 1-BEN (Beneficiary Pays All Fees), 2-OUR (Sender Pays All Fees), 3-SHA (Shared Fees).

updatedAt

withdrawalType

描述变更:
旧: First or third party withdrawal
新: First or third party withdrawal Enum values: - 1 - 2

Get Crypto Deposit

路径: /v1.0/payment/getCryptoDeposit → /v2.0/payment/getCryptoDeposit
方法: GET

响应体变更:

data

udpatedAt (删除)

类型: integer

必填: False

描述: Update time

updatedAt (新增)

类型: integer

必填: False

描述: Update time

status

描述变更:
旧: Status
新: Status 1 DETECTED 2 CONFIRMED 3 KYT FAILED 4 PENDDING TRAVELRULE 5 TRAVELRULE COMPLETED 6 REJECTED 7 COMPLETED

枚举值变更: 新增: [9]

Get Crypto Deposit History

路径: /v1.0/payment/getCryptoDepositHistory → /v2.0/payment/getCryptoDepositHistory
方法: GET

响应体变更:

data

transactions

udpatedAt (删除)

类型: integer

必填: False

描述: Update time

updatedAt (新增)

类型: integer

必填: False

描述: Update time

status

描述变更:
旧: Status
新: Status 1 DETECTED 2 CONFIRMED 3 KYT FAILED 4 PENDDING TRAVELRULE 5 TRAVELRULE COMPLETED 6 REJECTED 7 COMPLETED

枚举值变更: 新增: [9]

Get Crypto Withdrawal

路径: /v1.0/payment/getCryptoWithdrawal → /v2.0/payment/getCryptoWithdrawal
方法: GET

响应体变更:

data

amount

类型: number -> string

beneficiaryWallet

ownerInfo

必填: False -> True

描述变更:
旧: required if "isOwner" is false
新: Owner information

platformUserId

描述变更:
旧: Platform user id
新: required if "walletType" is "Platform Wallet"

feeAmount

类型: number -> string

kytInfo

kytResult

描述变更:
旧: KYT result: 1-Passed, 2-Manual Review, 3-High Risk.
新: KYT result: 1-Passed, 2-Failed, 3-High Risk.

kytType

描述变更:
旧: kytType
新: KYT type. 1-Wallet Screening; 2-Transaction Screening

Get Crypto Withdrawal History

路径: /v1.0/payment/getCryptoWithdrawalHistory → /v2.0/payment/getCryptoWithdrawalHistory
方法: GET

响应体变更:

data

transactions

amount

类型: number -> string

beneficiaryWallet

ownerInfo

必填: False -> True

描述变更:
旧: required if "isOwner" is false
新: Owner information

platformUserId

描述变更:
旧: Platform user id
新: required if "walletType" is "Platform Wallet"

feeAmount

类型: number -> string

getTnC

路径: /v2.0/tool/getTnC/{tncId}
方法: GET

响应体变更:

data

effectiveFrom

类型: string -> integer

描述变更:
旧: Effective date of the T&C
新: Effective date of the T&C (Unix timestamp in milliseconds)

Create Conversion

路径: /v1.0/trade/conversion/createConversion → /v2.0/trade/conversion/createConversion
方法: POST

响应体变更:

data

destinationAmount

描述变更:
旧: Amount of destination currency, sourceAmount or destinationAmount must fill one.
新: Amount of destination currency

Create Quotation

路径: /v1.0/trade/conversion/createQuotation → /v2.0/trade/conversion/createQuotation
方法: POST

请求体变更:

clientReference (删除)

类型: string

必填: False

destinationAmount

描述变更:
旧: Amount of destination currency, sourceAmount or destinationAmount must fill one.
新: Amount of destination currency

响应体变更:

data

clientReference (删除)

类型: string

必填: False

destinationAmount

描述变更:
旧: Amount of destination currency, sourceAmount or destinationAmount must fill one.
新: Amount of destination currency

Get Conversion

路径: /v1.0/trade/conversion/getConversion → /v2.0/trade/conversion/getConversion
方法: GET

响应体变更:

data

destinationAmount

描述变更:
旧: Amount of destination currency, sourceAmount or destinationAmount must fill one.
新: Amount of destination currency

Get Quotation

路径: /v1.0/trade/conversion/getQuotation → /v2.0/trade/conversion/getQuotation
方法: GET

响应体变更:

data

destinationAmount

描述变更:
旧: Amount of destination currency, sourceAmount or destinationAmount must fill one.
新: Amount of destination currency

Conversion Webhook

类型: Webhook
名称: Conversion Webhook
方法: POST

请求体变更:

data

destinationAmount

描述变更:
旧: Amount of destination currency, sourceAmount or destinationAmount must fill one.
新: Amount of destination currency

eventType

描述变更:
旧: api_conversion_status_update
新: conversion.updated.v2

Crypto Checkout Webhook

类型: Webhook
名称: Crypto Checkout Webhook
方法: POST

请求体变更:

data

cryptoCheckout (删除)

类型: object

必填: True

amountToPay (新增)

类型: string

必填: True

描述: Amount to be paid

buyerInfo (新增)

必填: True

描述: Buyer information

checkoutWallets (新增)

类型: object

必填: True

描述: A list of wallet addresses for accepting crypto payment

clientReference (新增)

类型: string

必填: False

描述: External reference for the crypto checkout

conversions (新增)

类型: array

必填: False

cryptoCheckoutId (新增)

类型: string

必填: True

描述: Unique identifier of the crypto checkout request.

currencyToPay (新增)

类型: string

必填: True

描述: Currency code

expiry (新增)

类型: integer

必填: True

描述: Timestamp for payment request expiry.

participantCode (新增)

类型: string

必填: True

描述: Participant's code

paymentPurpose (新增)

类型: object

必填: False

描述: Optional purchase order or payment intent details

receivedPayments (新增)

类型: array

必填: False

status (新增)

类型: integer

必填: False

描述: Current status of the crypto checkout
1 PENDING
2 PAYMENT DETECTED
3 PAYMENT ACCEPTED
4 EXPIRED
5 CLOSED
6 WALLET SCREENING COMPLETED
7 KYT COMPLETED
8 CONVERSION INITIATED
9 CONVERSION SETTLED

枚举值: [1, 2, 3, 4, 5, 6, 7, 8, 9]

walletKyt (新增)

类型: object

必填: False

eventType

描述变更:
旧: api_payment_request_status_update
新: crypto.checkout.updated.v2

Crypto Collection Wallet Webhook

类型: Webhook
名称: Crypto Collection Wallet Webhook
方法: POST

请求体变更:

eventType

描述变更:
旧: api_wallet_address_status_update
新: crypto.wallet.address.updated.v2

Crypto Collection Webhook

类型: Webhook
名称: Crypto Collection Webhook
方法: POST

请求体变更:

data

amount

类型: number -> string

eventType

描述变更:
旧: api_payment_status_update
新: crypto.payment.updated.v2

Crypto Deposit Webhook

类型: Webhook
名称: Crypto Deposit Webhook
方法: POST

请求体变更:

data

udpatedAt (删除)

类型: integer

必填: False

描述: Update time

updatedAt (新增)

类型: integer

必填: False

描述: Update time

status

描述变更:
旧: Status
新: Status 1 DETECTED 2 CONFIRMED 3 KYT FAILED 4 PENDDING TRAVELRULE 5 TRAVELRULE COMPLETED 6 REJECTED 7 COMPLETED

枚举值变更: 新增: [9]

eventType

描述变更:
旧: Webhook event type = "api_deposit_crypto_status_update"
新: crypto.deposit.updated.v2

Crypto Refund Webhook

类型: Webhook
名称: Crypto Refund Webhook
方法: POST

请求体变更:

data

txnHash (删除)

类型: string

必填: False

描述: Transaction hash of the refund. Only available when status is COMPLETED

txHash (新增)

类型: string

必填: False

描述: Transaction hash of the refund. Only available when status is COMPLETED

eventType

描述变更:
旧: api_refund_status_update
新: crypto.refund.updated.v2

Crypto Withdrawal Webhook

类型: Webhook
名称: Crypto Withdrawal Webhook
方法: POST

请求体变更:

data

amount

类型: number -> string

beneficiaryWallet

ownerInfo

必填: False -> True

描述变更:
旧: required if "isOwner" is false
新: Owner information

platformUserId

描述变更:
旧: Platform user id
新: required if "walletType" is "Platform Wallet"

feeAmount

类型: number -> string

kytInfo

kytResult

描述变更:
旧: KYT result: 1-Passed, 2-Manual Review, 3-High Risk.
新: KYT result: 1-Passed, 2-Failed, 3-High Risk.

kytType

描述变更:
旧: kytType
新: KYT type. 1-Wallet Screening; 2-Transaction Screening

eventType

描述变更:
旧: api_withdrawal_crypto_status_update
新: crypto.withdrawal.updated.v2

Fiat Account Request Status Webhook

类型: Webhook
名称: Fiat Account Request Status Webhook
方法: POST

响应体变更:

data

createdAt

status

描述变更:
旧: Status of the request
新: Status of the request Enum values: - 1: PENDING - 2: PROCESSING - 3: ACTIVE - 4: REJECTED

updatedAt

eventType

描述变更:
旧: api_fiat_account_request_status_update
新: fiat.account.request.updated.v2

Fiat Deposit Webhook

类型: Webhook
名称: Fiat Deposit Webhook
方法: POST

请求体变更:

data

createdAt

类型: string -> integer

描述变更:
旧: Timestamp of deposit transaction, ISO-8601
新: Timestamp of deposit transaction (Unix timestamp in milliseconds)

eventType

描述变更:
旧: Webhook event type = "api_deposit_status_update"
新: fiat.deposit.updated.v2

Fiat Withdrawal Webhook

类型: Webhook
名称: Fiat Withdrawal Webhook
方法: POST

请求体变更:

data

amount

类型: number -> string

createdAt

estimatedAmountReceivable

类型: number -> string

fees

类型: number -> string

status

枚举值变更: 删除: [5]

swiftChargingCode

描述变更:
旧:
新: Swift charging code: 1-BEN (Beneficiary Pays All Fees), 2-OUR (Sender Pays All Fees), 3-SHA (Shared Fees).

updatedAt

withdrawalType

描述变更:
旧: First or third party withdrawal
新: First or third party withdrawal Enum values: 1: First Party 2: Third Party

eventType

描述变更:
旧: Webhook event type = "api_withdrawal_status_update"
新: fiat.withdrawal.updated.v2

Activate Same Name Withdrawal Webhook

类型: Webhook
名称: fiatPayoutOnboardingStatus
方法: POST

响应体变更:

eventType

描述变更:
旧: api_fiat_payout_onboarding_status_update
新: fiat.withdrawal.capability.updated.v2

Merchant Status Webhook

类型: Webhook
名称: Merchant Status Webhook
方法: POST

请求体变更:

data

updateAt (删除)

类型: integer

必填: True

描述: Update timestamp, UNIX timestamp in milliseconds (e.g., 1715000000000)

updatedAt (新增)

类型: integer

必填: True

描述: Update timestamp, UNIX timestamp in milliseconds (e.g., 1715000000000)

merchantInfo

merchantDetails

additionalPersonalDetails

sourceOfWealth

必填: False -> True

描述变更:
旧: Source of wealth (If HIGH risk and/or PEP)
新: Source of wealth

personalDetails

contactNumber

描述变更:
旧:
新: Phone number for contact, country code + Number. eg, +65 87654321

dateOfBirth

描述变更:
旧: Date of birth (UTC format)
新: Date of birth, format: YYYY-MM-DD, e.g., 1990-05-15

taxResidency

描述变更:
旧:
新: The country of tax residency (Country Code in ISO 3166-1 alpha-2 format)

corporationDetails

dateOfIncorporation

描述变更:
旧: Date of Incoporation
新: Date of Incoporation, format: YYYY-MM-DD, e.g., 1990-05-15

status

描述变更:
旧: Indicates the current status of the application
新: Indicates the current status of the application Enum values: - 1: PROCESSING - 2: APPROVED - 3: REJECTED

eventType

描述变更:
旧: Webhook event type = "api_merchant_status_update_v2"
新: merchant.updated.v2

删除的API

GET /v1.0/crm/addressBook/getBuyer

Get Buyer

POST /v1.0/crm/addressBook/updateBuyer

Update Buyer

GET /v1.0/payment/getStatement

Get Settlement Statement

新增的API

GET /crm/addressBook/getBuyer

Get Buyer

POST /crm/addressBook/updateBuyer

Update Buyer

无变化的API

方法	路径	摘要
GET	`/v2.0/crm/fiatAccount/capabilities`	Get Fiat Account Capabilities
POST	`/v2.0/crm/fiatAccount/request`	Create Fiat Account Request
POST	`/v2.0/payment/fiat/addInfo/submit`	Submit Additional Information for Fiat Withdrawal Request
POST	`/v2.0/payment/fiat/sameNameWithdrawal/activate`	Activate Same Name Withdrawal
POST	`/v2.0/payment/fiat/sameNameWithdrawalAddInfo/submit`	Submit Additional Information for Activating Same Name Withdrawal
GET	`/v2.0/payment/fiat/sameNameWithdrawalCapabilities`	Get Same Name Withdrawal Capabilities

Changelog 20260402

v2.1 vs v2.0#

统计概览#

修改的API详情#

Buyer Status Webhook#

Upload File#

Add Bank Account#

Get Bank Accounts#

Create Buyer#

Create Merchant#

Get Merchant#

Get Deposit Bank Account#

Create Collection Wallet#

Get Collection Wallet#

Update Collection Wallet#

Get Crypto Deposit Wallet#

Submit Additional Information for Fiat Account Request#

Get Fiat Account Application Status#

Get Balance#

Create Token#

Get Internal Transfer#

Internal Transfer#

Close Crypto Checkout#

Confirm Crypto Refund#

Create Crypto Checkout#

Create Crypto Checkout Link#

Create Crypto Refund#

Create Crypto Withdrawal#

Crypto Checkout Wallet Connection#

Get Convertible Cryptos#

Get Crypto Checkout#

Get Crypto Checkout Currencies#

Get Crypto Checkout Link#

Get Crypto Collection#

Get Crypto Refund#

Get Supported Blockchains#

Get Wallet Address#

Generate POS Payment Request#

Register Wallet Address#

Remove Wallet Address#

Update Co-KYT status#

Update Crypto Deposit Travel Rule Info#

Create Fiat Withdrawal#

Get Fiat Deposit Detail#

Get Fiat Deposit History#

Get Fiat Withdrawal Detail#

Get Fiat Withdrawal History#

Get Crypto Deposit#

Get Crypto Deposit History#

Get Crypto Withdrawal#

Get Crypto Withdrawal History#

getTnC#

Create Conversion#

Create Quotation#

Get Conversion#

Get Quotation#

Conversion Webhook#

Crypto Checkout Webhook#

Crypto Collection Wallet Webhook#

Crypto Collection Webhook#

Crypto Deposit Webhook#

Crypto Refund Webhook#

Crypto Withdrawal Webhook#

Fiat Account Request Status Webhook#

Fiat Deposit Webhook#

Fiat Withdrawal Webhook#

Activate Same Name Withdrawal Webhook#

Merchant Status Webhook#

删除的API#

新增的API#

无变化的API#

v2.1 vs v2.0

统计概览

修改的API详情

Buyer Status Webhook

Upload File

Add Bank Account

Get Bank Accounts

Create Buyer

Create Merchant

Get Merchant

Get Deposit Bank Account

Create Collection Wallet

Get Collection Wallet

Update Collection Wallet

Get Crypto Deposit Wallet

Submit Additional Information for Fiat Account Request

Get Fiat Account Application Status

Get Balance

Create Token

Get Internal Transfer

Internal Transfer

Close Crypto Checkout

Confirm Crypto Refund

Create Crypto Checkout

Create Crypto Checkout Link

Create Crypto Refund

Create Crypto Withdrawal

Crypto Checkout Wallet Connection

Get Convertible Cryptos

Get Crypto Checkout

Get Crypto Checkout Currencies

Get Crypto Checkout Link

Get Crypto Collection

Get Crypto Refund

Get Supported Blockchains

Get Wallet Address

Generate POS Payment Request

Register Wallet Address

Remove Wallet Address

Update Co-KYT status

Update Crypto Deposit Travel Rule Info

Create Fiat Withdrawal

Get Fiat Deposit Detail

Get Fiat Deposit History

Get Fiat Withdrawal Detail

Get Fiat Withdrawal History

Get Crypto Deposit

Get Crypto Deposit History

Get Crypto Withdrawal

Get Crypto Withdrawal History

getTnC

Create Conversion

Create Quotation

Get Conversion

Get Quotation

Conversion Webhook

Crypto Checkout Webhook

Crypto Collection Wallet Webhook

Crypto Collection Webhook

Crypto Deposit Webhook

Crypto Refund Webhook

Crypto Withdrawal Webhook

Fiat Account Request Status Webhook

Fiat Deposit Webhook

Fiat Withdrawal Webhook

Activate Same Name Withdrawal Webhook

Merchant Status Webhook

删除的API

新增的API

无变化的API