{
    "id": null,
    "status": "pending",
    "amount": {
        "currency": null,
        "value": null
    },
    "sourceFinancialAccount": {
        "id": null
    },
    "destinationFinancialAccount": {
        "id": null
    },
    "financialTransactionReference": null,
    "description": null,
    "failureDetail": {
        "code": "unknown",
        "message": null
    },
    "ownershipGraph": {
        "owner": {
            "id": null,
            "type": null,
            "metadata": null,
            "": null
        }
    },
    "createTime": null,
    "updateTime": null,
    "metadata": null
}
Internal Transfer represents internal fund movements between financial accounts. Useful for wallet top-ups, inter-account routing, and internal settlements. 
{
    "id": null,
    "status": "pending",
    "amount": {
        "currency": null,
        "value": null
    },
    "sourceFinancialAccount": {
        "id": null
    },
    "destinationFinancialAccount": {
        "id": null
    },
    "financialTransactionReference": null,
    "description": null,
    "failureDetail": {
        "code": "unknown",
        "message": null
    },
    "ownershipGraph": {
        "owner": {
            "id": null,
            "type": null,
            "metadata": null,
            "": null
        }
    },
    "createTime": null,
    "updateTime": null,
    "metadata": null
}
​
📋
Properties
​
id
string
Unique identifier for this transfer object.
​
status
enum<string>
Current status of the transfer:
  • ‘pending’: Created but not yet processed.
  • ‘processing’: Currently being processed.
  • ‘failed’: Transfer failed.
  • ‘completed’: Transfer successfully completed.
Available options: pending processing failed completed
​
amount
object
Amount to be transferred from the source to the destination account.
​
sourceFinancialAccount
object
Source financial account from which the funds will be debited.
​
destinationFinancialAccount
object
Destination financial account to which the funds will be credited.
​
financialTransactionReference
string
Reference to the resulting financial transaction(s), if the transfer was completed.
​
description
string
Human-readable description of the transfer. Useful for developer context, admin UIs, or logs.
​
failureDetail
object
Failure details, populated only when the transfer status is ‘failed’.
​
ownershipGraph
object
Ownership chain that shows which object or action triggered the transfer — enabling audit traceability.
​
createTime
string
Timestamp indicating when the transfer was created.
​
updateTime
string
Timestamp of the most recent update to the transfer.
​
metadata
object
Custom metadata for tagging this transfer with additional context or identifiers.