{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/en/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["tabs","tab","partial"]},"type":"markdown"},"seo":{"title":"Statuses in SimPay","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":"statuses-in-simpay","__idx":0},"children":["Statuses in SimPay"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select the type of statuses you are interested in to learn more about their meaning and use in our system."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"id":"statusGroup","size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Transaction Statuses","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every transaction in the SimPay system has its own lifecycle, represented by appropriate statuses. A status change informs about the current stage of payment processing – from the moment of initiation to successful completion, rejection, or refund."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following diagram shows the possible transition paths between individual transaction statuses in our API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"transaction-lifecycle","__idx":1},"children":["Transaction Lifecycle"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"file":"/_diagrams/en/payment_transaction_statuses.mermaid","type":"mermaid","diagramType":"mermaid","diagramSource":"flowchart LR\n%% Start node\n Start([Start]) --> NEW[transaction_new]\n\n%% Transitions from NEW\n NEW -->|Generation| GENERATED[transaction_generated]\n NEW -->|Time expired| EXPIRED[transaction_expired]\n\n%% Transitions from GENERATED\n GENERATED -->|Confirmation| CONFIRMED[transaction_confirmed]\n GENERATED -->|Time expired| EXPIRED\n\n%% Transitions from CONFIRMED\n CONFIRMED -->|Payment accepted| PAID[transaction_paid]\n CONFIRMED -->|Payment rejected| FAILURE[transaction_failure]\n CONFIRMED -->|Fraud suspicion| FRAUD_POSSIBILITY[transaction_fraud_possibility]\n CONFIRMED -->|Time expired| EXPIRED\n\n%% Transitions from PAID\n PAID -->|100% amount refunded| REFUNDED[transaction_refunded]\n PAID -->|Fraud confirmed| FRAUD[transaction_fraud]\n\n%% Transitions from FRAUD_POSSIBILITY\n FRAUD_POSSIBILITY -->|Resolved positively| PAID\n FRAUD_POSSIBILITY -->|No authorization| FAILURE\n FRAUD_POSSIBILITY -->|Confirmed| FRAUD\n\n%% SIMPAY BRAND STYLES AND ADDITIONAL\n classDef pendingNode fill:#e6efff,stroke:#0057FF,stroke-width:2px,color:#000\n classDef successNode fill:#e6faee,stroke:#00D14F,stroke-width:2px,color:#000\n classDef refundNode fill:#f0fdf4,stroke:#4ade80,stroke-width:2px,color:#000\n classDef failNode fill:#ffe4e6,stroke:#e11d48,stroke-width:2px,color:#000\n classDef warningNode fill:#fef3c7,stroke:#d97706,stroke-width:2px,color:#000\n classDef plainNode fill:#ffffff,stroke:#000000,stroke-width:2px,color:#000\n\n class Start plainNode\n class NEW,GENERATED,CONFIRMED pendingNode\n class PAID successNode\n class REFUNDED refundNode\n class EXPIRED,FAILURE failNode\n class FRAUD_POSSIBILITY,FRAUD warningNode\n\n","diagramHtml":"

Generation

Time expired

Confirmation

Time expired

Payment accepted

Payment rejected

Fraud suspicion

Time expired

100% amount refunded

Fraud confirmed

Resolved positively

No authorization

Confirmed

Start

transaction_new

transaction_generated

transaction_expired

transaction_confirmed

transaction_paid

transaction_failure

transaction_fraud_possibility

transaction_refunded

transaction_fraud

","diagramHtmlDark":"

Generation

Time expired

Confirmation

Time expired

Payment accepted

Payment rejected

Fraud suspicion

Time expired

100% amount refunded

Fraud confirmed

Resolved positively

No authorization

Confirmed

Start

transaction_new

transaction_generated

transaction_expired

transaction_confirmed

transaction_paid

transaction_failure

transaction_fraud_possibility

transaction_refunded

transaction_fraud

"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"description-of-individual-statuses","__idx":2},"children":["Description of Individual Statuses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In our API responses, the transaction status is returned as a string. The following table explains the meaning of each:"]},{"$$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 ( enum )"},"children":["Status (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enum"]},")"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"center","data-label":"Type"},"children":["Type"]},{"$$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":"code","attributes":{},"children":["transaction_new"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Processing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Initial status after creating a new transaction in the system. Payment awaits further steps."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_generated"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Processing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The customer selected a payment method and proceeded to pay"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_confirmed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Processing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The payment method informed us about the initiation of payment processing."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_paid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Success"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Payment was successfully completed and funds have been secured. This is the main status of a successful transaction. You can proceed to fulfill the order"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_failure"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Payment was rejected (e.g., insufficient funds, authorization denied by bank, 3D Secure error)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_expired"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error / Expiration"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The time allocated for paying the transaction has elapsed. The payment path is irreversibly closed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_refunded"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Refund"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["A successful full refund (100% of the amount) was made to the payer's account."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_fraud_possibility"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Verification"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The system detected an anomaly or risk. The transaction requires additional verification before final approval or rejection."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_fraud"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Critical Error"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The transaction was flagged as fraud (e.g., stolen card, chargeback). Funds will not be transferred."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Integration Tip"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_paid"]}," status is the only status indicating correct and final payment of the order by the customer (unless a refund occurs later)."," ","Your application should fulfill the order (deliver goods/services) only after receiving a webhook with this status."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-are-you-informed-about-status-changes","__idx":3},"children":["How Are You Informed About Status Changes?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transaction and refund status changes occur asynchronously in our system (e.g., after bank payment approval). For your application to react immediately to these changes – for example, to deliver purchased goods to the customer – we provide two synchronization methods:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IPN Notifications"]}," – this is the recommended, fastest, and most secure method. Every time a transaction changes its status, SimPay will send an automatic notification (POST request) to the URL you configured."," ","Details about the structure of these notifications and events can be found in the section:"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/notifications/payment/events/transaction_status_changed"},"children":["Transaction Status Change"]}]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Verification (Polling)"]}," – at any time, you can also independently retrieve the current status of a specific operation by sending a query directly to our API."," ","The exact endpoint description for checking the status can be found here:"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/payment/paymentgettransaction"},"children":["Transaction Status"]}]},"."]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Best Practice"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend basing your business logic (e.g., order fulfillment) primarily on IPN notifications. API polling should serve only as a fallback mechanism or for one-time status verification before taking critical actions."]}]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Refund Statuses","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Similar to transactions themselves, the refund process has its own simplified lifecycle. Tracking these statuses allows you to verify whether funds have already been successfully sent back to the customer's account, or if a problem occurred along the way."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following diagram shows the possible transitions between individual refund stages:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"refund-lifecycle","__idx":4},"children":["Refund Lifecycle"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"file":"/_diagrams/en/payment_transaction_refund_statuses.mermaid","type":"mermaid","diagramType":"mermaid","diagramSource":"flowchart LR\n%% Start node\n Start([Start]) --> NEW[refund_new]\n\n%% Transitions from NEW\n NEW -->|Forwarded for processing| PENDING[refund_pending]\n NEW -->|Refund rejected| FAILED[refund_failed]\n\n%% Transitions from PENDING\n PENDING -->|Refund approved| COMPLETED[refund_completed]\n PENDING -->|Refund rejected| REJECTED[refund_rejected]\n PENDING -->|Processing error| FAILED\n\n%% SIMPAY BRAND STYLES\n%% Blue (Secondary #0057FF) for pending processes\n classDef pendingNode fill:#e6efff,stroke:#0057FF,stroke-width:2px,color:#000\n\n%% Green (Primary #00D14F) for full success\n classDef successNode fill:#e6faee,stroke:#00D14F,stroke-width:2px,color:#000\n\n%% Red for errors and rejections\n classDef failNode fill:#ffe4e6,stroke:#e11d48,stroke-width:2px,color:#000\n\n%% Neutral for start\n classDef plainNode fill:#ffffff,stroke:#000000,stroke-width:2px,color:#000\n\n%% Style assignments\n class Start plainNode\n class NEW,PENDING pendingNode\n class COMPLETED successNode\n class REJECTED,FAILED failNode\n\n","diagramHtml":"

Forwarded for processing

Refund rejected

Refund approved

Refund rejected

Processing error

Start

refund_new

refund_pending

refund_failed

refund_completed

refund_rejected

","diagramHtmlDark":"

Forwarded for processing

Refund rejected

Refund approved

Refund rejected

Processing error

Start

refund_new

refund_pending

refund_failed

refund_completed

refund_rejected

"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"description-of-individual-refund-statuses","__idx":5},"children":["Description of Individual Refund Statuses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table explains the meaning of each status appearing in the context of refund operations (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RefundStatus"]},"):"]},{"$$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 ( enum )"},"children":["Status (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enum"]},")"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"center","data-label":"Type"},"children":["Type"]},{"$$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":"code","attributes":{},"children":["refund_new"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Processing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The refund was successfully created in the system and awaits processing."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refund_pending"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Processing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The refund request was sent to the payment operator or bank. The operation is in progress."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refund_completed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Success"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Final positive status. The refund was successfully completed, and funds are being returned to the payer's account."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refund_rejected"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The refund request was rejected (e.g., by the bank or due to insufficient balance in the store's account)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refund_failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["A technical error occurred during the refund attempt (e.g., error in communication with external API). Process was aborted."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Good to Know"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refund_completed"]}," status means that SimPay successfully processed the refund. However, keep in mind that the time for funds to appear in the customer's bank account depends on their bank or card issuer."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-are-you-informed-about-status-changes-1","__idx":6},"children":["How Are You Informed About Status Changes?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transaction and refund status changes occur asynchronously in our system (e.g., after bank payment approval). For your application to react immediately to these changes – for example, to deliver purchased goods to the customer – we provide two synchronization methods:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IPN Notifications"]}," – this is the recommended, fastest, and most secure method. Every time a transaction or refund changes its status, SimPay will send an automatic notification (POST request) to the URL you configured."," ","Details about the structure of these notifications and events can be found in the section:"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/notifications/payment/events/transaction_refund_status_changed"},"children":["Refund Status Change"]}]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Verification (Polling)"]}," – at any time, you can also independently retrieve the current status of a specific operation by sending a query directly to our API."," ","The exact endpoint description for checking the status can be found here:"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/payment/paymenttransactionrefundshow"},"children":["Refund Status"]}]},"."]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Best Practice"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend basing your business logic (e.g., order fulfillment) primarily on IPN notifications. API polling should serve only as a fallback mechanism or for one-time status verification before taking critical actions."]}]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"BLIK Alias Statuses","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Registration and management of linked BLIK aliases is done asynchronously. Tracking the alias status allows you to determine whether the customer can already make quick payments (so-called ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OneClick"]}," - alias ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UID"]},") or whether you can automatically charge their account as part of recurrent payments (",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Subscriptions"]}," - alias ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYID"]},"), without the need to enter the six-digit code from the banking app each time."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following diagram shows the alias lifecycle in our system:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"blik-alias-lifecycle","__idx":7},"children":["BLIK Alias Lifecycle"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"file":"/_diagrams/en/blik_alias_statuses.mermaid","type":"mermaid","diagramType":"mermaid","diagramSource":"flowchart LR\n%% Start node\n Start([Start]) --> PENDING[alias_pending_registration]\n\n%% Transitions from PENDING\n PENDING -->|Authorization successful| ACTIVE[alias_active]\n PENDING -->|Time expired| EXPIRED[alias_expired]\n PENDING -->|Refused / Deregistered| UNREGISTERED[alias_unregistered]\n\n%% Transitions from ACTIVE\n ACTIVE -->|Time expired| EXPIRED\n ACTIVE -->|Deregistered by user| UNREGISTERED\n\n%% SIMPAY BRAND STYLES\n classDef pendingNode fill:#e6efff,stroke:#0057FF,stroke-width:2px,color:#000\n classDef successNode fill:#e6faee,stroke:#00D14F,stroke-width:2px,color:#000\n classDef failNode fill:#ffe4e6,stroke:#e11d48,stroke-width:2px,color:#000\n classDef plainNode fill:#ffffff,stroke:#000000,stroke-width:2px,color:#000\n\n class Start plainNode\n class PENDING pendingNode\n class ACTIVE successNode\n class EXPIRED,UNREGISTERED failNode\n\n","diagramHtml":"

Authorization successful

Time expired

Refused / Deregistered

Time expired

Deregistered by user

Start

alias_pending_registration

alias_active

alias_expired

alias_unregistered

","diagramHtmlDark":"

Authorization successful

Time expired

Refused / Deregistered

Time expired

Deregistered by user

Start

alias_pending_registration

alias_active

alias_expired

alias_unregistered

"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"description-of-individual-statuses-1","__idx":8},"children":["Description of Individual Statuses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table explains the meaning of each status appearing in the BLIK alias lifecycle (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AliasStatus"]},"):"]},{"$$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 ( enum )"},"children":["Status (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enum"]},")"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"center","data-label":"Type"},"children":["Type"]},{"$$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":"code","attributes":{},"children":["alias_pending_registration"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Processing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The alias was initiated in the system and awaits approval (registration) by the buyer in their mobile banking app."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alias_active"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Active"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The alias was successfully registered. You can use it to initiate quick payments (OneClick) and execute recurrent payments (Subscriptions)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alias_expired"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Terminated"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The active alias has expired. You should ask the customer to re-register."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alias_unregistered"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Terminated"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The buyer deregistered the alias in their mobile banking app or in the SimPay Billing Panel."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-are-you-informed-about-status-changes-2","__idx":9},"children":["How Are You Informed About Status Changes?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Similar to standard transactions, the alias lifecycle is based on events dependent on customer actions. For your application to know in real time whether a given alias is already active or has been deregistered, we provide two synchronization methods:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IPN Notifications"]}," – this is the recommended, fastest, and most secure method. Every time a transaction or refund changes its status, SimPay will send an automatic notification (POST request) to the URL you configured."," ","Details about the structure of these notifications and events can be found in the section:"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/notifications/payment/events/blik_alias_status_changed"},"children":["BLIK Alias Status Change"]}]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Verification (Polling)"]}," – at any time, you can also independently retrieve the current status of a specific operation by sending a query directly to our API."," ","The exact endpoint description for checking the status can be found here:"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/payment/paymentblikaliasesindex"},"children":["BLIK Alias Status"]}]},"."]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Best Practice"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend basing your business logic (e.g., order fulfillment) primarily on IPN notifications. API polling should serve only as a fallback mechanism or for one-time status verification before taking critical actions."]}]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Subscription Statuses","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The subscription system allows for cyclical, automatic charging of the customer's selected payment method. Each subscription goes through its lifecycle – from the moment of creation and authorization, through the period of activity, to its completion (natural, cancellation, or expiration e.g., due to insufficient funds)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following diagram shows the possible transitions between subscription statuses:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"subscription-lifecycle","__idx":10},"children":["Subscription Lifecycle"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"file":"/_diagrams/en/subscription_statuses.mermaid","type":"mermaid","diagramType":"mermaid","diagramSource":"flowchart LR\n%% Start node\n Start([Start]) --> PENDING[subscription_pending]\n\n%% Transitions from PENDING\n PENDING -->|Activation successful| ACTIVE[subscription_active]\n PENDING -->|Cancellation| CANCELLED[subscription_cancelled]\n PENDING -->|Fraud suspicion| FRAUDULENT[subscription_fraudulent]\n\n%% Transitions from ACTIVE\n ACTIVE -->|Insufficient funds / Expired| EXPIRED[subscription_expired]\n ACTIVE -->|Plan completed| FINISHED[subscription_finished]\n ACTIVE -->|Fraud detected| FRAUDULENT\n\n%% SIMPAY BRAND STYLES\n classDef pendingNode fill:#e6efff,stroke:#0057FF,stroke-width:2px,color:#000\n classDef successNode fill:#e6faee,stroke:#00D14F,stroke-width:2px,color:#000\n classDef failNode fill:#ffe4e6,stroke:#e11d48,stroke-width:2px,color:#000\n classDef warningNode fill:#fef3c7,stroke:#d97706,stroke-width:2px,color:#000\n%% Neutral gray for naturally completed\n classDef finishedNode fill:#f3f4f6,stroke:#4b5563,stroke-width:2px,color:#000\n classDef plainNode fill:#ffffff,stroke:#000000,stroke-width:2px,color:#000\n\n class Start plainNode\n class PENDING pendingNode\n class ACTIVE successNode\n class CANCELLED,EXPIRED failNode\n class FRAUDULENT warningNode\n class FINISHED finishedNode\n\n","diagramHtml":"

Activation successful

Cancellation

Fraud suspicion

Insufficient funds / Expired

Plan completed

Fraud detected

Start

subscription_pending

subscription_active

subscription_cancelled

subscription_fraudulent

subscription_expired

subscription_finished

","diagramHtmlDark":"

Activation successful

Cancellation

Fraud suspicion

Insufficient funds / Expired

Plan completed

Fraud detected

Start

subscription_pending

subscription_active

subscription_cancelled

subscription_fraudulent

subscription_expired

subscription_finished

"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table explains the meaning of each status appearing in the recurrent payment lifecycle (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SubscriptionStatus"]},"):"]},{"$$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 ( enum )"},"children":["Status (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enum"]},")"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"center","data-label":"Type"},"children":["Type"]},{"$$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":"code","attributes":{},"children":["subscription_pending"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Processing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The subscription was created in the system and awaits payment method authorization by the customer. No fund collection possible."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subscription_active"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Active"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The subscription was successfully activated. Cyclical charges can be made according to the set schedule."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subscription_cancelled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Terminated"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The subscription was cancelled by the customer, store, or failed to activate properly. No further charges will be made."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subscription_expired"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Expiration"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The active subscription has expired (e.g., due to loss of payment method validity)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subscription_finished"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Successfully Completed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The subscription cycle has ended according to the original plan/order schedule."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subscription_fraudulent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Critical Error"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The subscription was flagged as fraud (e.g., chargeback or use of stolen data). The process is immediately blocked."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-are-you-informed-about-status-changes-3","__idx":11},"children":["How Are You Informed About Status Changes?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Since subscriptions are long-term processes (renewing e.g., monthly), it is crucial to automate receiving information about their status. We provide two data synchronization methods:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IPN Notifications"]}," – this is the absolutely recommended method for handling recurrent payments. When a subscription changes status (e.g., expires or successfully collects the next installment), SimPay will send a POST request to your application."," ","Details about the structure of these notifications and events can be found in the section:"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/notifications/payment/events/subscription_status_changed"},"children":["Subscription Status Change"]}]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Verification (Polling)"]}," – at any time, you can also independently retrieve the current status of a specific operation by sending a query directly to our API."," ","The exact endpoint description for checking the status can be found here:"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/payment/paymentsubscriptionindex"},"children":["Subscription Status"]}]},"."]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Best Practice"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend basing your business logic (e.g., order fulfillment) primarily on IPN notifications. API polling should serve only as a fallback mechanism or for one-time status verification before taking critical actions."]}]}]}]}]},"headings":[{"value":"Statuses in SimPay","id":"statuses-in-simpay","depth":1},{"value":"Transaction Lifecycle","id":"transaction-lifecycle","depth":2},{"value":"Description of Individual Statuses","id":"description-of-individual-statuses","depth":2},{"value":"How Are You Informed About Status Changes?","id":"how-are-you-informed-about-status-changes","depth":2},{"value":"Refund Lifecycle","id":"refund-lifecycle","depth":2},{"value":"Description of Individual Refund Statuses","id":"description-of-individual-refund-statuses","depth":3},{"value":"How Are You Informed About Status Changes?","id":"how-are-you-informed-about-status-changes-1","depth":2},{"value":"BLIK Alias Lifecycle","id":"blik-alias-lifecycle","depth":2},{"value":"Description of Individual Statuses","id":"description-of-individual-statuses-1","depth":3},{"value":"How Are You Informed About Status Changes?","id":"how-are-you-informed-about-status-changes-2","depth":3},{"value":"Subscription Lifecycle","id":"subscription-lifecycle","depth":2},{"value":"How Are You Informed About Status Changes?","id":"how-are-you-informed-about-status-changes-3","depth":3}],"frontmatter":{"seo":{"title":"Statuses in SimPay"}},"lastModified":"2026-05-13T09:55:40.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/en/payment/statuses","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}