Before creating Swap Transfer

Before creating Fiat Swap Transfer

Getting options for source

  • 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=individual' \
    --header 'accept: application/json' \
    --header 'mid: SAH1N3_STPN40_NA' \
    --header 'Authorization: Basic =='
    {
        "status": "success",
        "data": [
            {
                "currency": "BRL",
                "logoUrl": "https://common-fiat-logos.s3.ap-southeast-1.amazonaws.com/brl.svg",
                "decimalPrecision": 2
            },
            {
                "currency": "EUR",
                "logoUrl": "https://common-fiat-logos.s3.ap-southeast-1.amazonaws.com/eur.svg",
                "decimalPrecision": 2
            },
            {
                "currency": "GHS",
                "logoUrl": "https://common-fiat-logos.s3.ap-southeast-1.amazonaws.com/ghs.svg",
                "decimalPrecision": 2
            },
            {
                "currency": "IDR",
                "logoUrl": "https://common-fiat-logos.s3.ap-southeast-1.amazonaws.com/idr.svg",
                "decimalPrecision": 0
            }
        ],
        "pagination": {
            "total": 4,
            "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&userType=individual&headlessMode=true&currency=EUR' \
    --header 'accept: application/json' \
    --header 'mid: SAH1N3_NA_NA' \
    --header 'Authorization: Basic =='
    {
        "status": "success",
        "data": [
              {
                "name": "Open Banking",
                "paymentCode": "sepa_pull",
                "paymentType": "bank_transfer",
                "logoUrl": "https://common-payment-methods-logo.s3.ap-southeast-1.amazonaws.com/open_banking.svg",
                "iframeSupport": false,
                "minAmount": 1,
                "maxAmount": 100000,
                "additionalDetails": {}
            },
            {
                "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",
                "iframeSupport": true,
                "minAmount": 1,
                "maxAmount": 150000,
                "additionalDetails": {
                    "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",
                "iframeSupport": true,
                "minAmount": 1,
                "maxAmount": 100000,
                "additionalDetails": {
                    "street": {
                        "type": "string"
                    },
                    "city": {
                        "type": "string"
                    },
                    "postalCode": {
                        "type": "string"
                    }
                }
            }
        ],
        "pagination": {
            "total": 3,
            "pages": 1,
            "currentPage": 1,
            "limit": 1000,
            "hasNext": false,
            "hasPrev": true
        }
    }

Getting options for destination

  • Get a list of supported currencies enabled for your MID (API link):
    curl --location 'https://sandbox-api.transfi.com/v3/config/supported-currencies?direction=withdraw&limit=100&page=1&userType=individual' \
    --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
            },
            {
                "currency": "VND",
                "logoUrl": "https://common-fiat-logos.s3.ap-southeast-1.amazonaws.com/vnd.svg",
                "decimalPrecision": 0
            }
        ],
        "pagination": {
            "total": 3,
            "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=withdraw&limit=20&page=1&userType=individual&currency=EUR' \
    --header 'accept: application/json' \
    --header 'mid: SAH1N3_NA_NA' \
    --header 'Authorization: Basic =='
    {
        "status": "success",
        "data": [
            {
                "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": 150000,
                "additionalDetails": {
                    "firstName": {
                        "type": "string"
                    },
                    "lastName": {
                        "type": "string"
                    },
                    "email": {
                        "type": "string"
                    },
                    "iban": {
                        "type": "string",
                        "min": 15,
                        "max": 34,
                        "pattern": "^[A-Z]{2}[0-9]{2}[A-Z0-9]{1,30}$"
                    },
                    "bic": {
                        "type": "string",
                        "min": 4,
                        "max": 12,
                        "pattern": "^[A-Z0-9]+$"
                    },
                    "street": {
                        "type": "string"
                    },
                    "city": {
                        "type": "string"
                    },
                    "postalCode": {
                        "type": "string"
                    }
                }
            }
        ],
        "pagination": {
            "total": 1,
            "pages": 1,
            "currentPage": 1,
            "limit": 20,
            "hasNext": false,
            "hasPrev": false
        }
    }

Getting exchange rates

  • From source currency to destination currency(API link):
    curl --location 'https://sandbox-api.transfi.com/v3/exchange-rates?sourceCurrency=EUR&destinationCurrency=USD&amount=250&paymentCode=sepa_bank&paymentType=bank_transfer&toPaymentCode=swift&toPaymentType=bank_transfer&direction=forward&orderType=swap' \
    --header 'mid: SAH5F0_NA_NA' \
    --header 'Authorization: Basic =='
    {
        "sourceCurrency": "EUR",
        "sourceAmount": 250,
        "sourceAmountInUsd": 296.23,
        "sourceCurrencyType": "fiat",
        "destinationCurrency": "USD",
        "destinationAmount": 296.2284671570177,
        "destinationAmountInUsd": 296.23,
        "destinationCurrencyType": "fiat",
        "conversionRate": 0.8439431983,
        "minLimit": 1,
        "maxLimit": 84394.32,
        "orderType": "swap",
        "direction": "forward",
        "exchangeRate": 1.1849138686280707,
        "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 Swap Transfer

Getting options for source

  • 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=individual&direction=deposit' \
    --header 'accept: application/json' \
    --header 'mid: SAH1N3_STYS7H_NA' \
    --header 'Authorization: Basic =='
    {
        "status": "success",
        "data": [
            {
                "symbol": "BNB",
                "cryptoTicker": "BNBBSC",
                "network": "Binance Smart Chain"
            },
            {
                "symbol": "USDC",
                "cryptoTicker": "USDC",
                "network": "Ethereum"
            },
            {
                "symbol": "TRX",
                "cryptoTicker": "TRX",
                "network": "Tron"
            },
            {
                "symbol": "USDC",
                "cryptoTicker": "USDCCELO",
                "network": "Celo"
            },
            {
                "symbol": "CUSD",
                "cryptoTicker": "CUSDCELO",
                "network": "CELO"
            }
        ],
        "pagination": {
            "total": 34,
            "pages": 7,
            "currentPage": 1,
            "limit": 5,
            "hasNext": true,
            "hasPrev": false
        }
    }

Getting options for destination

  • 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=individual&direction=withdraw' \
    --header 'accept: application/json' \
    --header 'mid: SAH1N3_STYS7H_NA' \
    --header 'Authorization: Basic =='
    {
        "status": "success",
        "data": [
            {
                "symbol": "USDT",
                "cryptoTicker": "USDTTON",
                "network": "TON"
            },
            {
                "symbol": "PYUSD",
                "cryptoTicker": "PYUSD",
                "network": "Ethereum"
            },
            {
                "symbol": "SLP",
                "cryptoTicker": "SLPRON",
                "network": "Ronin"
            },
            {
                "symbol": "BKN",
                "cryptoTicker": "BKN",
                "network": "Ethereum"
            },
            {
                "symbol": "USDC",
                "cryptoTicker": "USDCFUSE",
                "network": "Fuse"
            }
        ],
        "pagination": {
            "total": 97,
            "pages": 20,
            "currentPage": 1,
            "limit": 5,
            "hasNext": true,
            "hasPrev": false
        }
    }

Getting exchange rates

  • From source currency to destination currency(API link):
    curl --location 'https://sandbox-api.transfi.com/v3/exchange-rates?sourceCurrency=USDC&destinationCurrency=BTC&amount=250&direction=forward&orderType=swap' \
    --header 'mid: SAH5F0_NA_NA' \
    --header 'Authorization: Basic =='
    {
        "sourceCurrency": "USDC",
        "sourceAmount": 250,
        "sourceAmountInUsd": 250,
        "sourceCurrencyType": "crypto",
        "destinationCurrency": "BTC",
        "destinationAmount": 0.003789,
        "destinationAmountInUsd": 250,
        "destinationCurrencyType": "crypto",
        "conversionRate": 1,
        "minLimit": 19.791573,
        "maxLimit": null,
        "orderType": "swap",
        "direction": "forward",
        "processingFee": 0,
        "processingFeeRate": 0,
        "customerFee": 0,
        "customerFeeRate": 0,
        "discount": 0,
        "discountRate": 0,
        "additionalFeeRate": 0,
        "totalFee": 0,
        "feeMode": "percentage"
    }