{"templateId":"markdown","versions":[{"version":"v1","label":"v1","link":"/pt-br/products/collections/concepts/channels","default":true,"active":true,"folderId":"3a2d3fa8"},{"version":"v0","label":"v0","link":"/pt-br/products/collections/v0/concepts/channels","default":false,"active":false,"folderId":"3a2d3fa8"}],"sharedDataIds":{"sidebar":"sidebar-@l10n/pt-BR/products/collections/@v0/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Channels","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","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":"channels","__idx":0},"children":["Channels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A payment channel represents a persistent way to collect from a payer into a beneficiary's account."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Where a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/collections/concepts/collections"},"children":["collection"]}," is a single payment request that expires, a channel is a standing arrangement. It stays open, and the payer can send funds through it repeatedly without a new link being generated each time. Each payment received through a channel is recorded as its own ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/collections/concepts/transactions"},"children":["transaction"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use a channel for an ongoing payer relationship — a recurring supplier, a marketplace seller collecting from the same buyer, a customer topping up a balance."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-channels-relate-to-other-resources","__idx":1},"children":["How channels relate to other resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A channel routes to an ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/collections/concepts/accounts"},"children":["account"]}," using its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_id"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/collections/concepts/partners"},"children":["partners"]}," involved are the payer and the beneficiary."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each payment through the channel produces a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/collections/concepts/transactions"},"children":["transaction"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Channel lifecycle changes emit ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CHANNEL_CREATED"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CHANNEL_ARCHIVED"]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/collections/concepts/webhooks"},"children":["webhook"]}," events."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-a-channel-closes","__idx":2},"children":["How a channel closes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can't close a channel yourself. Ripple closes a partner's channels automatically if the partner fails compliance screening. Each channel's status changes to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CLOSED"]},", and Ripple sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CHANNEL_ARCHIVED"]}," webhook event for each one."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-operations","__idx":3},"children":["API operations"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/collections/api/collections/collection-channels/createchannelv1"},"children":["Create a channel"]},": Generate a new payment channel between a beneficiary and payer."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/collections/api/collections/collection-channels/listchannelsv1"},"children":["List channels"]},": Retrieve a list of all channels, which can be filtered by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payer_id"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["beneficiary_id"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/collections/api/collections/collection-channels/getchannelbyidv1"},"children":["Get channel details"]},": View the full details and current status of a single channel."]}]}]},"headings":[{"value":"Channels","id":"channels","depth":1},{"value":"How channels relate to other resources","id":"how-channels-relate-to-other-resources","depth":2},{"value":"How a channel closes","id":"how-a-channel-closes","depth":2},{"value":"API operations","id":"api-operations","depth":2}],"frontmatter":{"seo":{"title":"Channels"}},"lastModified":"2026-10-07T18:01:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/pt-br/products/collections/concepts/channels","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}