{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/en/simpay-flow/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Payment channels","description":"Znajdziesz tutaj wszystkie niezbędne informacje dotyczące integracji i obsługi systemu płatności SimPay.pl","siteUrl":"https://docs.simpay.pl","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-channels","__idx":0},"children":["Payment channels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each submerchant has its own set of payment channels (BLIK, bank transfers, cards, PayPal, deferred payments, etc.). You manage them through the SimPay Flow API - usually in the settings panel of your application, where the submerchant chooses which payment methods to offer."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All channel operations are available only for submerchants with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_submerchant_active"]}," status."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"default-channels","__idx":1},"children":["Default channels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After onboarding is approved, the submerchant automatically receives active and enabled channels for all payment methods that have an active default rate in your Flow service (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en/simpay-flow/commissions#default-and-dedicated-rates"},"children":["Commissions"]},"). Channels for methods enabled later must be ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#registering-a-new-channel"},"children":["registered"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"submerchant-channel-list","__idx":2},"children":["Submerchant channel list"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/flow/flowgetsubmerchantpaymentchannels"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /flow/{flowServiceId}/submerchants/{submerchantId}/payment-channels"]}]}," returns all submerchant channels with:"]},{"$$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":{"data-label":"Field"},"children":["Field"]},{"$$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":["id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Channel ID, e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blik"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blik-level0"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paypal"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Channel status: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["new"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in_progress"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["active"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rejected"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enabled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Whether the channel is enabled (visible to payers)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirect"]}," - payment on the SimPay gateway, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["whitelabel"]}," - payment directly on your site"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["commission"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["SimPay commission (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["simpay"]},") and your commission (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow"]},") - see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en/simpay-flow/commissions"},"children":["Commissions"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extra"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Additional data for selected channels (BLIK OneClick, BLIK Recurring Payments, PayPal)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A channel is available to payers only when it has the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["active"]}," status ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["and"]}," is enabled (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enabled: true"]},")."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"enabling-and-disabling-channels","__idx":3},"children":["Enabling and disabling channels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You enable and disable active channels with the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/flow/flowupdatesubmerchantpaymentchannels"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH /flow/{flowServiceId}/submerchants/{submerchantId}/payment-channels"]}]}," request:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X PATCH \"https://api.simpay.pl/flow/{flowServiceId}/submerchants/user-123/payment-channels\" \\\n  -H \"Authorization: Bearer YOUR_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"channels\": [\n      { \"slug\": \"blik\", \"enabled\": true },\n      { \"slug\": \"paypal\", \"enabled\": false }\n    ]\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Channels that don't exist, are not active yet or have no active commission in your Flow service are skipped without an error."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"registering-a-new-channel","__idx":4},"children":["Registering a new channel"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Get the list of channels the submerchant can register: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/flow/flowgetsubmerchantavailablepaymentchannels"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET .../payment-channels/available-for-registration"]}]},". The list contains only channels for which your Flow service has an active commission and which the submerchant doesn't have yet."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Register the selected channel: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/flow/flowregistersubmerchantpaymentchannel"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST .../payment-channels/register"]}]}," with the channel ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},"."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://api.simpay.pl/flow/{flowServiceId}/submerchants/user-123/payment-channels/register\" \\\n  -H \"Authorization: Bearer YOUR_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ \"id\": \"paypo\" }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After registration:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a channel that ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["doesn't require verification"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["needs_verification: false"]},") immediately gets the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["active"]}," status,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a channel that ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["requires verification"]}," gets the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["new"]}," status and is verified by SimPay (or registered with the payment method operator). We will notify you about the status change with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_submerchant_payment_channel:status_changed"]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en/simpay-flow/webhooks"},"children":["webhook"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"The channel is disabled by default"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A newly registered channel has ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enabled: false"]},". Once it's active, enable it with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH .../payment-channels"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Some channels (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requires_company: true"]},") are available only for submerchants with a registered business. For an unregistered business, the API returns the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CHANNEL_REQUIRES_COMPANY"]}," error."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"special-channels","__idx":5},"children":["Special channels"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"blik-level-0--oneclick","__idx":6},"children":["BLIK Level 0 + OneClick"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Register and activate the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blik-level0"]}," channel."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST .../payment-channels/register"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"id\": \"blik-level0-oneclick\""]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You'll find the OneClick request status in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extra.blikOneClick"]}," of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blik-level0"]}," channel: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PENDING_REGISTRATION"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REGISTERED_WAITING_ACTIVATION"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]}," (or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REJECTED"]},")."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["OneClick is available only for submerchants with a registered business. More about the service itself: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/payment/blik/level0_oneclick"},"children":["BLIK Level 0 + OneClick"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"blik-recurring-payments","__idx":7},"children":["BLIK Recurring Payments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You'll find the active recurring payment models (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A"]}," - AUTO, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["O"]}," - OPEN, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["M"]}," - MANUAL) in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extra.blikRecurrent.models"]}," of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blik-recurrent"]}," channel. More: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/payment/blik/recurrent"},"children":["BLIK Recurring Payments"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"paypal","__idx":8},"children":["PayPal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paypal"]}," channel, set the submerchant's PayPal account email with the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/flow/flowupdatesubmerchantpaypal"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT .../payment-channels/paypal"]}]}," request. You'll find the current email in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extra.paypalCheckoutEmail"]},"."]}]},"headings":[{"value":"Payment channels","id":"payment-channels","depth":1},{"value":"Default channels","id":"default-channels","depth":2},{"value":"Submerchant channel list","id":"submerchant-channel-list","depth":2},{"value":"Enabling and disabling channels","id":"enabling-and-disabling-channels","depth":2},{"value":"Registering a new channel","id":"registering-a-new-channel","depth":2},{"value":"Special channels","id":"special-channels","depth":2},{"value":"BLIK Level 0 + OneClick","id":"blik-level-0--oneclick","depth":3},{"value":"BLIK Recurring Payments","id":"blik-recurring-payments","depth":3},{"value":"PayPal","id":"paypal","depth":3}],"frontmatter":{"seo":{"title":"Payment channels"}},"lastModified":"2026-10-01T15:18:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/en/simpay-flow/channels","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}