{"templateId":"markdown","versions":[{"version":"v2026.03","label":"v2026.03","link":"/products/payments-direct-2/api-docs/concepts/payment-execution-details","default":true,"active":true,"folderId":"eb16255d"},{"version":"v2025.11","label":"v2025.11","link":"/products/payments-direct-2/v2025.11/api-docs/concepts/payment-execution-details","default":false,"active":false,"folderId":"eb16255d"}],"sharedDataIds":{"sidebar":"sidebar-products/payments-direct-2/@v2025.11/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Payout execution details","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com/products/custody","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"payout-execution-details","__idx":0},"children":["Payout execution details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a payment is processed, Ripple Payments Direct may return execution metadata from the payout network in an optional field called ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutExecutionDetails"]}," on the Get Payment by ID response. When present, this object provides tracking information that can be used for audit, reconciliation, or customer inquiry resolution."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutExecutionDetails"]}," is not returned on every payment. Its presence depends on whether the network that processed the payment supports execution detail reporting. Treat this field as optional enrichment and do not build required workflows that depend on its presence."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fields","__idx":1},"children":["Fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutExecutionDetails"]}," object contains the following fields:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"30%","data-label":"Field"},"children":["Field "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentRailUsed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payment rail or network used to execute the payout (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FEDWIRE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACH"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SEPA_CT"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutStartTime"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 timestamp"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The time at which payout execution began, in UTC."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutEndTime"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 timestamp"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The time at which payout execution completed or was last updated, in UTC. For in-progress payouts, this may represent the last status update time."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["trackingReferences"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["One or more network-specific tracking identifiers. See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#tracking-references"},"children":["Tracking references"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tracking-references","__idx":2},"children":["Tracking references"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each entry in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["trackingReferences"]}," array represents a single network-specific identifier for the payment. The array may contain more than one entry."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"30%","data-label":"Field"},"children":["Field "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referenceType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifies what the reference value represents (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IMAD"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["END_TO_END_REFERENCE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CRYPTO_TRANSACTION_HASH"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The reference value."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["displayName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A human-readable label for the reference type."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A brief explanation of the reference type."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referenceType"]}," field to identify what each value represents. Do not rely on the position of entries in the array, as the order is not guaranteed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example","__idx":3},"children":["Example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following is an example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutExecutionDetails"]}," object as it would appear in a Get Payment by ID response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"payoutExecutionDetails\": {\n    \"paymentRailUsed\": \"FEDWIRE\",\n    \"payoutStartTime\": \"2026-02-18T14:22:15.789Z\",\n    \"payoutEndTime\": \"2026-02-18T14:25:30.123Z\",\n    \"trackingReferences\": [\n      {\n        \"referenceType\": \"IMAD\",\n        \"value\": \"20260218MMQFMP2P003836\",\n        \"displayName\": \"Input Message Accountability Data\",\n        \"description\": \"A unique identifier assigned by the Fedwire system to each transaction.\"\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"guidance","__idx":4},"children":["Guidance"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutExecutionDetails"]}," should be treated as informational only. Do not build required workflows that depend on its presence, as availability varies and is not guaranteed for any specific payment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When present, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["trackingReferences"]}," provides network-specific identifiers useful for audit, reconciliation, or customer inquiry resolution."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referenceType"]}," field on each tracking reference to identify what a value represents rather than relying on its position in the array."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Coverage will expand as additional corridors and networks are onboarded."]}]}]},"headings":[{"value":"Payout execution details","id":"payout-execution-details","depth":1},{"value":"Fields","id":"fields","depth":2},{"value":"Tracking references","id":"tracking-references","depth":2},{"value":"Example","id":"example","depth":2},{"value":"Guidance","id":"guidance","depth":2}],"frontmatter":{"title":"Payout execution details","seo":{"title":"Payout execution details"}},"lastModified":"2026-04-03T15:45:06.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/payments-direct-2/api-docs/concepts/payment-execution-details","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}