Payment Method Query

Introduction

This interface is used to query supported payment methods based on fiat currency and cryptocurrency.
This interface can only be called on the server-side.

Domains

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

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

API Description

Request Method: POST

Content-Type: application/json

Request Parameters

Header Parameters:

ParameterRequiredTypeDescription
appidYstringPartner's unique ID, merchants joining Alchemy Pay will receive credentials including appId and appSecret.
timestampYstringCurrent UTC 13-digit timestamp, valid within 5 minutes
signYstringSignature, you can refer to the signature here

Body Parameters:

ParameterRequiredTypeDescription
fiatYstring3-letter fiat code, e.g., USD
cryptoYstringCryptocurrency, e.g., USDT
networkYstringCryptocurrency network, e.g., ETH/BSC/BTC
sideYstringOrder type, currently only supports BUY (uppercase)

Request Example

Request Parameter Example:

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

Response Parameters

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

Response Parameter Example:

{
    "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 CodeReturn Message
81012crypto is not supported
81013crypto and network do not match
81016fiat not match

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