Introduction

This interface is used to query supported payment methods based on fiat currency and cryptocurrency.

Interface Description

Test Environment

https://openapi-test.alchemypay.org/open/api/v4/merchant/query/cryptoFiatMethod

Production Environment

https://openapi.alchemypay.org/open/api/v4/merchant/query/cryptoFiatMethod

❗️This interface can only be called on the server-side.

Request Method

POST
Content-Type: application/json

Header Parameters

Parameter	Required	Type	Description
appid	Y	string	Partner's unique ID, merchants joining Alchemy Pay will receive credentials including appId and appSecret.
timestamp	Y	string	Current UTC 13-digit timestamp, valid within 5 minutes
sign	Y	string	Signature, you can refer to the signature here

Body Parameters

Parameter	Required	Type	Description
fiat	Y	string	3-letter fiat code, e.g., USD
crypto	Y	string	Cryptocurrency, e.g., USDT
network	Y	string	Cryptocurrency network, e.g., ETH/BSC/BTC
side	Y	string	Order type, currently only supports BUY (uppercase)

Example

Request Parameters

Request Header parameters:

Request Body parameters:

{
    "appid": "ahzxh0klegv1fzol",
    "fiat": "USD",
    "crypto": "USDT",
    "network":"TRX",
   "side": "BUY"
}

Response Parameters

Note: If the input parameter "fiat" is "EUR", the response will be "country": "DE".

{
    "success": true,
    "returnCode": "0000",
    "returnMsg": "SUCCESS",
    "extend": "",
    "data": [
        {
            "country": "US",
            "payWayCode": "53001",
            "minPurchaseAmount": "100.00",
            "maxPurchaseAmount": "2000.00"
        },
        {
            "country": "US",
            "payWayCode": "53002",
            "minPurchaseAmount": "100.00",
            "maxPurchaseAmount": "2000.00"
        },
        {
            "country": "US",
            "payWayCode": "701",
            "minPurchaseAmount": "3.00",
            "maxPurchaseAmount": "2000.00"
        },
        {
            "country": "US",
            "payWayCode": "501",
            "minPurchaseAmount": "3.00",
            "maxPurchaseAmount": "2000.00"
        },
        {
            "country": "US",
            "payWayCode": "10001",
            "minPurchaseAmount": "3.00",
            "maxPurchaseAmount": "2000.00"
        }
    ],
    "traceId": "6538b94dd2b15a185f6477e36beeb234"
}

Return Code List

Return Code	Return Message
81012	crypto is not supported
81013	crypto and network do not match
81016	fiat not match

Other return codes reference: https://dash.readme.com/project/alchemypay/v4.0.1/docs/response-code-list