{"templateId":"markdown","versions":[{"version":"v2026.03","label":"v2026.03","link":"/products/payments-direct-2/user-interface/payments/payment-approvals","default":true,"active":true,"folderId":"eb16255d"},{"version":"v2025.11","label":"v2025.11","link":"/products/payments-direct-2/v2025.11/user-interface/payments/payment-approvals","default":false,"active":false,"folderId":"eb16255d"}],"sharedDataIds":{"sidebar":"sidebar-products/payments-direct-2/@v2025.11/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Payment approvals","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":"payment-approvals","__idx":0},"children":["Payment approvals"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The payment approvals feature requires that a payment be reviewed and approved by a designated user before it is processed. This provides an additional layer of oversight for cross-border payment operations and is sometimes referred to as a maker/checker workflow."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The payment approvals feature must be enabled for your account before you can use it. Contact your ","Ripple Payments"," account manager to enable this feature."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"roles","__idx":1},"children":["Roles"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The payment approvals workflow uses two roles:"]},{"$$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":{"align":"left","data-label":"Role"},"children":["Role"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Maker"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Creates a payment and submits it for approval. The maker cannot approve their own payment."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Checker"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Reviews a pending payment approval request and approves, rejects, or cancels it."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"approval-log","__idx":2},"children":["Approval log"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approval log"]}," tab on the Payments page displays all submitted payment approval requests. Select any row to open the approval review panel with full payment and approval details."]},{"$$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":{"align":"left","data-label":"Column"},"children":["Column"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Date"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The date and time the payment was submitted for approval."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Beneficiary"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The beneficiary of the payment."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sending amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The sending amount and currency of the payment."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Receiving amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The receiving amount and currency of the payment."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Initiator"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The email address of the maker who submitted the payment for approval."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approval status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The current approval status of the payment. See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#approval-statuses"},"children":["Approval statuses"]}," for a description of each status."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Action"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Review"]}," button. Appears only for payments in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pending"]}," status. Select it to open the approval review panel."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"approval-statuses","__idx":3},"children":["Approval statuses"]},{"$$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":{"align":"left","data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pending"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The payment is awaiting a decision. Displays a live countdown showing the time remaining before the associated quote expires."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approved"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["A checker approved the payment and it has been sent for processing."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rejected"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["A checker rejected the payment. The rejection reason is visible in the approval review panel."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cancelled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The maker cancelled the approval request before a decision was made."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Expired"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No decision was made before the payment quote expired. Once expired, the approval request cannot be approved, rejected, or cancelled."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"approval-review-panel","__idx":4},"children":["Approval review panel"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Selecting a row in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approval log"]}," opens the approval review panel. The panel displays the following information:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Payment amount, sending currency, and receiving currency"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Beneficiary details"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Originator details"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Quote details, including a live countdown timer showing when the quote expires"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Approval activity history, including who submitted, approved, rejected, or cancelled the request and when"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For payments in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approved"]}," status, the panel also includes a link to the corresponding payment record."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a quote expires, no further action can be taken on the approval request. The approval status changes to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Expired"]}," and all action buttons are removed from the panel."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"approve-a-payment","__idx":5},"children":["Approve a payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only a checker can approve a payment. A maker cannot approve their own payment."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To approve a payment:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payments"]}," tab."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approval log"]}," tab."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Review"]}," next to the payment you want to approve."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review the payment details in the approval review panel and confirm the quote has not expired."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approve and send"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The payment is sent for processing and the approval status changes to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approved"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reject-a-payment","__idx":6},"children":["Reject a payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only a checker can reject a payment."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To reject a payment:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payments"]}," tab."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approval log"]}," tab."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Review"]}," next to the payment you want to reject."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reject"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reject payment"]}," dialog, select one or more reasons for the rejection:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Incorrect information"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cost (FX + fees)"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Purpose of transaction not defined"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Duplicate payment"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Other reason"]}," — if selected, enter a brief description in the text field (50 characters maximum)"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reject payment"]}," to confirm."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The approval status changes to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rejected"]},". The maker can view the rejection reason by selecting the payment in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approval log"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cancel-an-approval-request","__idx":7},"children":["Cancel an approval request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only the maker who submitted the payment can cancel an approval request, and only while the payment is in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pending"]}," status."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To cancel an approval request:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payments"]}," tab."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approval log"]}," tab."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the payment you want to cancel."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cancel"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The approval status changes to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cancelled"]},"."]}]},"headings":[{"value":"Payment approvals","id":"payment-approvals","depth":1},{"value":"Roles","id":"roles","depth":2},{"value":"Approval log","id":"approval-log","depth":2},{"value":"Approval statuses","id":"approval-statuses","depth":2},{"value":"Approval review panel","id":"approval-review-panel","depth":2},{"value":"Approve a payment","id":"approve-a-payment","depth":2},{"value":"Reject a payment","id":"reject-a-payment","depth":2},{"value":"Cancel an approval request","id":"cancel-an-approval-request","depth":2}],"frontmatter":{"seo":{"title":"Payment approvals"}},"lastModified":"2026-03-31T03:43:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/payments-direct-2/user-interface/payments/payment-approvals","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}