Create transfer

Create a new transfer to move funds from one Qolo Account to another.

Following are different types of transfer supported in the platform

Partner to Card - Partner can transfer funds from progfund account to card using card proxy or account guid Account to External bank accounts (Add outside_instrument and then use the guid in this API) External bank accounts to Account (Add outside_instrument and then use the guid in this API) This API supports transfer with currency conversions and this api uses the exchange rates provided by our banking partner.

Request
Security:
Bearer
path Parameters
version
required
string
Request Body schema: application/json
client_reference_id
required
string non-empty

API Partner can send the transfer's unique id on their system and it can be used to fetch transfer details later

channel_type
string (ChannelType)
Enum: "NotSet" "ACH" "SameDayACH" "RTP" "Wire" "ManualWire" "CrossBorder"
transfer_type
required
string (TransferType)
Enum: "UNKNOWN" "CARDTOCARD" "PARTNERTOCARD" "CARDTOPARTNER" "PARTNERTOPARTNER" "ACCOUNTTOACCOUNT" "ACCOUNTTOBANK" "BANKTOACCOUNT" "CHECKLOAD" "CHECKUNLOAD" "CARDTOPARTNER_UNLOADTOZERO" "CCDCTOACCOUNT" "ACCOUNTTOCCDC" "ACCOUNTTOBANKREALTIME" "BANKTOACCOUNTREQUESTREALTIME" "ACCOUNTTOCHECK" "PARTNERTOCHECK"
amount
required
number <double>

Amount to transfer.

currency
required
string 3 characters

Three letter currency code

description
string or null [ 0 .. 48 ] characters

API Partner can send the transfer's description for reference

required
object (TransferDetail)
required
object (TransferDetail)
quote_reference
string or null

For cross currency transfers, quote should be created and must be passed in transfer.

object (QuoteResponse)
destination_amount
number <double>
destination_currency
string or null
memo_code
string or null <= 64 characters

Client driven code used to add more details to the transfer type.

verification_code
string or null

Verification code. This field is currently not used and cvv2 validation during the transfer is not required

object (EFTInfo)
reason_code
string or null [ 0 .. 16 ] characters

Transfer reason code used for foreign exchange

Responses
201

Returns the newly created transfer

400

Bad request

401

Unauthorized

404

Account not found

500

Server Error

post/api/{version}/transfers
Request samples
application/json
{
  • "client_reference_id": "string",
  • "channel_type": "NotSet",
  • "transfer_type": "UNKNOWN",
  • "amount": 0,
  • "currency": "str",
  • "description": "string",
  • "source": {
    • "account_guid": "d2b7c9d2-85e7-4c51-92d0-3f97a47f8d76",
    • "wallet_guid": "17eaeda9-c0ab-4ac3-8ef9-27ac9b388a03",
    • "wallet_id": "string",
    • "card_proxy": "string",
    • "outside_instrument_guid": "f2fb9354-2f4f-40d1-819c-4ff2a66a4bd8"
    },
  • "destination": {
    • "account_guid": "d2b7c9d2-85e7-4c51-92d0-3f97a47f8d76",
    • "wallet_guid": "17eaeda9-c0ab-4ac3-8ef9-27ac9b388a03",
    • "wallet_id": "string",
    • "card_proxy": "string",
    • "outside_instrument_guid": "f2fb9354-2f4f-40d1-819c-4ff2a66a4bd8"
    },
  • "quote_reference": "string",
  • "quoteoutput": {
    • "source": {
      • "account_guid": "d2b7c9d2-85e7-4c51-92d0-3f97a47f8d76",
      • "wallet_guid": "17eaeda9-c0ab-4ac3-8ef9-27ac9b388a03",
      • "wallet_id": "string",
      • "card_proxy": "string",
      • "outside_instrument_guid": "f2fb9354-2f4f-40d1-819c-4ff2a66a4bd8"
      },
    • "destination": {
      • "account_guid": "d2b7c9d2-85e7-4c51-92d0-3f97a47f8d76",
      • "wallet_guid": "17eaeda9-c0ab-4ac3-8ef9-27ac9b388a03",
      • "wallet_id": "string",
      • "card_proxy": "string",
      • "outside_instrument_guid": "f2fb9354-2f4f-40d1-819c-4ff2a66a4bd8"
      },
    • "fees": [
      • {
        • "name": "string",
        • "amount": 0,
        • "currency": "string"
        }
      ],
    • "conversionDetails": {
      • "reference": "string",
      • "conversion_rate": 0,
      • "from_currency": "string",
      • "to_currency": "string",
      • "from_amount": 0,
      • "to_amount": 0,
      • "expiry_seconds": 0,
      • "expiry_at": "2019-08-24T14:15:22Z"
      }
    },
  • "destination_amount": 0,
  • "destination_currency": "string",
  • "memo_code": "string",
  • "verification_code": "string",
  • "eft_info": {
    • "sec_code": "WEB",
    • "identifier_number": "string",
    • "addenda": "string"
    },
  • "reason_code": "string"
}
Response samples
application/json
{
  • "txn_guid": "0017d7fb-f072-440d-86fd-a7ae6238e591",
  • "amount": 0,
  • "currency": "string",
  • "description": "string",
  • "source": {
    • "account_guid": "d2b7c9d2-85e7-4c51-92d0-3f97a47f8d76",
    • "wallet_guid": "17eaeda9-c0ab-4ac3-8ef9-27ac9b388a03",
    • "wallet_id": "string",
    • "card_proxy": "string",
    • "outside_instrument_guid": "f2fb9354-2f4f-40d1-819c-4ff2a66a4bd8"
    },
  • "destination": {
    • "account_guid": "d2b7c9d2-85e7-4c51-92d0-3f97a47f8d76",
    • "wallet_guid": "17eaeda9-c0ab-4ac3-8ef9-27ac9b388a03",
    • "wallet_id": "string",
    • "card_proxy": "string",
    • "outside_instrument_guid": "f2fb9354-2f4f-40d1-819c-4ff2a66a4bd8"
    },
  • "destination_amount": 0,
  • "destination_currency": "string",
  • "entry_date": "2019-08-24T14:15:22Z"
}
Copyright © Qolo 2019-2023. All right reserved.