Before creating Payin Transfer

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

Before creating Fiat-Payin 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=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
        }
    }
  • 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=credit_card&paymentType=card&direction=forward&orderType=payin' \
    --header 'mid: SAH5F0_SAMDWH_NA' \
    --header 'Authorization: Basic =='
    {
        "sourceCurrency": "EUR",
        "sourceAmount": 250,
        "sourceAmountInUsd": 293.3,
        "sourceCurrencyType": "fiat",
        "destinationCurrency": "USDC",
        "destinationAmount": 290.362431,
        "destinationAmountInUsd": 290.36,
        "destinationCurrencyType": "crypto",
        "conversionRate": 0.852382630283,
        "minLimit": 22,
        "maxLimit": 85238.26,
        "orderType": "payin",
        "direction": "forward",
        "processingFee": 2.5,
        "processingFeeRate": 0.01,
        "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": 2.5,
        "feeMode": "percentage"
    }

Before creating Crypto-Payin 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=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
        }
    }

  • Get exchange rates (payin currency to balanceCurrency) (API link):
    curl --location 'https://sandbox-api.transfi.com/v3/exchange-rates?sourceCurrency=USDC&destinationCurrency=EUR&amount=200&direction=forward&orderType=payin' \
    --header 'mid: SAH5F0_SAMDWH_NA' \
    --header 'Authorization: Basic =='
    {
        "sourceCurrency": "USDC",
        "sourceAmount": 200,
        "sourceAmountInUsd": 200,
        "sourceCurrencyType": "crypto",
        "destinationCurrency": "EUR",
        "destinationAmount": 168.771760796034,
        "destinationAmountInUsd": 198,
        "destinationCurrencyType": "fiat",
        "conversionRate": 0.852382630283,
        "minLimit": 1.007177,
        "maxLimit": 99999.996447,
        "orderType": "payin",
        "direction": "forward",
        "processingFee": 1.7,
        "processingFeeRate": 0.01,
        "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": 1.704765260566,
        "feeMode": "percentage"
    }