Before creating Prefund Order

This section describes step-by-step steps to be done, before you create your first payin transaction.

Before creating Fiat-Prefund transfer

  • Get a list of supported currencies enabled for your MID (API link):
    curl --location 'https://sandbox-api.transfi.com/v3/config/supported-currencies?direction=deposit&limit=100&page=1&userType=business' \
    --header 'accept: application/json' \
    --header 'mid: SAH1N3_STPN40_NA' \
    --header 'Authorization: Basic =='
    {
        "status": "success",
        "data": [
            {
                "currency": "EUR",
                "logoUrl": "https://common-fiat-logos.s3.ap-southeast-1.amazonaws.com/eur.svg",
                "decimalPrecision": 2
            },
            {
                "currency": "PHP",
                "logoUrl": "https://common-fiat-logos.s3.ap-southeast-1.amazonaws.com/php.svg",
                "decimalPrecision": 2
            }
        ],
        "pagination": {
            "total": 2,
            "pages": 1,
            "currentPage": 1,
            "limit": 100,
            "hasNext": false,
            "hasPrev": false
        }
    }
  • Get a list supported payment methods enabled for your MID (API link):
    curl --location 'https://sandbox-api.transfi.com/v3/config/payment-methods?direction=deposit&limit=20&page=1&headlessMode=true&currency=EUR&userType=business' \
    --header 'accept: application/json' \
    --header 'mid: SAH1N3_NA_NA' \
    --header 'Authorization: Basic =='
    {
        "status": "success",
        "data": [
            {
                "name": "SEPA Bank Transfer",
                "paymentCode": "sepa_bank_va",
                "paymentType": "bank_transfer",
                "logoUrl": "https://common-payment-methods-logo.s3.ap-southeast-1.amazonaws.com/sepa_bank.svg",
                "minAmount": 1,
                "maxAmount": 100000,
                "additionalDetails": {
                    "firstName": {
                        "type": "string"
                    },
                    "lastName": {
                        "type": "string"
                    },
                    "email": {
                        "type": "string"
                    },
                    "street": {
                        "type": "string"
                    },
                    "city": {
                        "type": "string"
                    },
                    "postalCode": {
                        "type": "string"
                    }
                }
            },
            {
                "name": "SEPA Instant",
                "paymentCode": "sepa_bank",
                "paymentType": "bank_transfer",
                "logoUrl": "https://common-payment-methods-logo.s3.ap-southeast-1.amazonaws.com/sepa_bank_va.svg",
                "minAmount": 1,
                "maxAmount": 100000,
                "additionalDetails": {
                    "firstName": {
                        "type": "string"
                    },
                    "lastName": {
                        "type": "string"
                    },
                    "email": {
                        "type": "string"
                    },
                    "street": {
                        "type": "string"
                    },
                    "city": {
                        "type": "string"
                    },
                    "postalCode": {
                        "type": "string"
                    }
                }
            }
        ],
        "pagination": {
            "total": 2,
            "pages": 1,
            "currentPage": 1,
            "limit": 20,
            "hasNext": false,
            "hasPrev": false
        }
    }
  • Get exchange rates (payin currency to balanceCurrency) (API link):
    curl --location 'https://sandbox-api.transfi.com/v3/exchange-rates?sourceCurrency=EUR&destinationCurrency=USDC&amount=250&paymentCode=Swift&paymentType=bank_transfer&direction=forward&orderType=fiat_prefund' \
    --header 'mid: SAH5F0_NA_NA' \
    --header 'Authorization: Basic =='
    {
        "sourceCurrency": "EUR",
        "sourceAmount": 250,
        "sourceAmountInUsd": 296.23,
        "sourceCurrencyType": "fiat",
        "destinationCurrency": "USDC",
        "destinationAmount": 296.228537,
        "destinationAmountInUsd": 296.23,
        "destinationCurrencyType": "crypto",
        "conversionRate": 0.8439431983,
        "minLimit": 22,
        "maxLimit": 84394.32,
        "orderType": "fiat_prefund",
        "direction": "forward",
        "processingFee": 0,
        "processingFeeRate": 0,
        "customerFee": 0,
        "customerFeeRate": 0,
        "rrFeeRate": 0,
        "discount": 0,
        "discountRate": 0,
        "additionalFee": 0,
        "fixedFee": {
            "totalFixedFees": 0,
            "totalFixedTfFees": 0,
            "totalFixedCxFees": 0,
            "fixedFeesCurrency": "",
            "fixedFeeDetails": {
                "baseFeeFixedRate": 0,
                "tfFeeFixedRate": 0,
                "cxFeeFixedRate": 0,
                "currency": ""
            }
        },
        "totalFee": 0,
        "feeMode": "percentage"
    }

Before creating Crypto-Prefund transfer

  • Get a list of crypto tokens available (API link):
    curl --location 'https://sandbox-api.transfi.com/v3/config/list-tokens?limit=10&page=1&userType=business&direction=deposit' \
    --header 'accept: application/json' \
    --header 'mid: SAH1N3_STYS7H_NA' \
    --header 'Authorization: Basic =='
    {
        "status": "success",
        "data": [
            {
                "symbol": "USDC",
                "cryptoTicker": "USDCCELO",
                "network": "Celo",
                "logo": "https://crypto-token-logos.s3.ap-southeast-1.amazonaws.com/usdccelo.svg",
                "description": "USD Coin"
            },
            {
                "symbol": "USDT",
                "cryptoTicker": "USDTPOLYGON",
                "network": "Polygon",
                "logo": "https://crypto-token-logos.s3.ap-southeast-1.amazonaws.com/usdtpolygon.svg",
                "description": "Tether"
            },
            {
                "symbol": "CUSD",
                "cryptoTicker": "CUSDCELO",
                "network": "CELO",
                "logo": "https://crypto-token-logos.s3.ap-southeast-1.amazonaws.com/cusdcelo.svg",
                "description": "Celo Dollar"
            },
            {
                "symbol": "USDC",
                "cryptoTicker": "USDCSOL",
                "network": "Solana",
                "logo": "https://crypto-token-logos.s3.ap-southeast-1.amazonaws.com/usdcsol.svg",
                "description": "USD Coin"
            },
            {
                "symbol": "LTC",
                "cryptoTicker": "LTC",
                "network": "Litecoin",
                "logo": "https://crypto-token-logos.s3.ap-southeast-1.amazonaws.com/ltc.svg",
                "description": "Litecoin"
            },
            {
                "symbol": "USDT",
                "cryptoTicker": "USDT",
                "network": "Ethereum",
                "logo": "https://crypto-token-logos.s3.ap-southeast-1.amazonaws.com/usdt.svg",
                "description": "Tether"
            },
            {
                "symbol": "ALGO",
                "cryptoTicker": "ALGO",
                "network": "Algorand",
                "logo": "https://crypto-token-logos.s3.ap-southeast-1.amazonaws.com/algo.svg",
                "description": "Algo"
            },
            {
                "symbol": "CELO",
                "cryptoTicker": "CELO",
                "network": "CELO",
                "logo": "https://crypto-token-logos.s3.ap-southeast-1.amazonaws.com/celo.svg",
                "description": "Celo"
            },
            {
                "symbol": "BCH",
                "cryptoTicker": "BCH",
                "network": "Bitcoin Cash",
                "logo": "https://crypto-token-logos.s3.ap-southeast-1.amazonaws.com/bch.svg",
                "description": "Bitcoin Cash"
            },
            {
                "symbol": "ETH",
                "cryptoTicker": "ETH",
                "network": "Ethereum",
                "logo": "https://crypto-token-logos.s3.ap-southeast-1.amazonaws.com/eth.svg",
                "description": "Ethereum"
            }
        ],
        "pagination": {
            "total": 38,
            "pages": 4,
            "currentPage": 1,
            "limit": 10,
            "hasNext": true,
            "hasPrev": false
        }
    }

  • Get exchange rates (payin currency to balanceCurrency) (API link):
    curl --location 'https://sandbox-api.transfi.com/v3/exchange-rates?sourceCurrency=USDC&destinationCurrency=EUR&amount=250&direction=forward&orderType=crypto_prefund' \
    --header 'mid: SAH5F0_NA_NA' \
    --header 'Authorization: Basic =='
    {
        "sourceCurrency": "USDC",
        "sourceAmount": 250,
        "sourceAmountInUsd": 250,
        "sourceCurrencyType": "crypto",
        "destinationCurrency": "EUR",
        "destinationAmount": 210.985799575,
        "destinationAmountInUsd": 250,
        "destinationCurrencyType": "fiat",
        "conversionRate": 0.8439431983,
        "minLimit": 0.995328,
        "maxLimit": 100000.000201,
        "orderType": "crypto_prefund",
        "direction": "forward",
        "processingFee": 0,
        "processingFeeRate": 0,
        "customerFee": 0,
        "customerFeeRate": 0,
        "rrFeeRate": 0,
        "discount": 0,
        "discountRate": 0,
        "additionalFee": 0,
        "additionalFeeRate": 0,
        "fixedFee": {
            "totalFixedFees": 0,
            "totalFixedTfFees": 0,
            "totalFixedCxFees": 0,
            "fixedFeesCurrency": "",
            "fixedFeeDetails": {
                "baseFeeFixedRate": 0,
                "tfFeeFixedRate": 0,
                "cxFeeFixedRate": 0,
                "currency": ""
            }
        },
        "totalFee": 0,
        "feeMode": "percentage"
    }