Purpose of Transfer

The transfer_purpose field is required under the destination object in your transfer request.

Harbor collects this field in order to comply with international regulatory frameworks such as:

Anti-Money Laundering (AML)
Counter-Terrorist Financing (CTF)
Cross-border transaction reporting obligations
Providing a correct and clear transfer purpose helps ensure your transfers are processed without unnecessary delay.

Example Request:

curl --location --request POST 'https://harbor-sandbox.owlpay.com/api/v1/transfer' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'X-API-KEY: {{API_KEY}}' \
--header 'Idempotency-Key: {{Idempotency-Key}}' \
--data-raw '{
    "commission": {
        "percentage": "0.01",
        "amount": "1.00"
    },
    "source": {
        "on_behalf_of": "cus_1234567890",
        "asset": "USD",
        "amount": "100.00"
    },
    "destination": {
        "asset": "USDC",
        "chain": "ethereum",
        "address": "0x4B20993Bc481177ec7E8f571ceCaE8A9e22C02db",
        "beneficiary_name": "John Doe",
        "transfer_purpose": "Salary"
    },
    "application_transfer_uuid": "{{YOUR_APPLICATION_TRANSFER_UUID}}"
}'

Recommended Values for transfer_purpose

Below is a list of suggested values to use for the transfer_purpose field.
Please choose the one that best matches the nature of the transaction:

`transfer_purpose` Value
Transfer to own account
Family Maintenance
Education-related student expenses
Medical Treatment
Hotel Accommodation
Travel
Utility Bills
Repayment of Loans
Tax Payment
Purchase of Residential Property
Payment of Property Rental
Insurance Premium
Product indemnity insurance
Insurance Claims Payment
Mutual Fund Investment
Investment in Shares
Donations
Salary
Information Service Charges
Advertising & Public relations-related expenses
Royalty fees, trademark fees, patent fees, and copyright fees
Fees for brokers, front end fee, commitment fee, guarantee fee and custodian fee
Fees for advisors, technical assistance, and academic knowledge, including remuneration for specialists
Representative office expenses
Construction costs/expenses
Transportation fees for goods
For payment of exported goods
Delivery fees for goods
General Goods Trades - Offline trade