Receiver-initiated accept of a pending Canton transfer that is awaiting our acceptance.
The pending inbound transfer is identified by its on-ledger TransferInstruction
contract id, which is surfaced to clients via getBulletins as a CANTON_TRANSFER_ACTION
bulletin. The instruction must be tracked locally; the receiving account
and address are resolved from the local record and the server enforces the
pending status / executeBefore deadline. To accept an instruction that is not
tracked locally, use acceptExternalCantonTransfer instead.
Returns a clear error if the instruction is unknown locally, no longer pending, or past
executeBefore. Use getPendingAcceptTransfers or CANTON_TRANSFER_ACTION bulletins to obtain
valid ids.
************** Request example **********************
acceptCantonTransfer(
coin_type="CC",
transfer_instruction_id="00d80b07940caec238f0e08e4a92c3926cc2c6c4ca9de0366a18f8227458ed1fe5ca1212201f37ff80520986751e271076b2994604b6d6f28d454fa68c1c9ea4383633775f",
)
************** Response example *********************
{
"FunctionData": {
"ApprovalRequestStatus": 0,
"CoinType": "CC",
"Token": "b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef12345678",
"Transactions": [
{
"AmountToTransfer": "0",
"DestinationAddress": "9c9151::12202e45dec9f7a89fb1e882a9289d2398d4f4ce4ef103f584a05c9b027d77f9ae60"
}
]
},
"Meta": {
"AccessToken": "58f08df6e369fa4d126e1ba5c7f66cf85c9c79df32d05fee8f3c542121c87cf5",
"Destination": "044fd7dc60304b8aceeb662ce41bf9d9cc132278c0871c0a72fb4f3cecbabb25a86e43ae28dab21a95c64e2db76abdcfffb9bfdeec67a21399cfa5f555f01d054b",
"Source": "be1f60e490b8ccabcc02a4595817b8edf45905d24944e87b8e3cae27f158df63843bfc4b09d37a5e752017b74ea2d136af272bea210f059e768e1ea8777aaf21e9",
"Time": "2025-10-19 15:04:13.129"
}
}
transfer_instruction_idstring<p>On-ledger TransferInstruction contract ID to accept</p>
coin_typestringThe Canton token symbol of the transfer
user_descriptionstring<p>Optional free-text description to attach to the accept transaction</p>