--- page_source: https://juspay.io/br/docs/hypercheckout-global/web/pix-via-open-finance/pisp-standard-redirection page_title: PISP (Standard Redirection) --- # PIX PISP Pix Initiation empowers merchants and wallet providers to offer seamless, embedded payment experiences directly from within their applications. Built on Open Finance standards, it allows users to initiate Pix transactions securely and instantly—directly redirecting the user to Bank environment and improve conversion by elevating the User Experience. ![Image](https://dth95m2xtyv8v.cloudfront.net/tesseract/assets/hypercheckout-global/PIX%20PISP%20New%20Flow%20Diagram_web.png) ## **Integration Guide:** --- ### Step 1 Session API Call This is a Server-to-Server [API](https://juspay.io/br/docs/hypercheckout-global/web/base-sdk-integration/session-api) that takes order parameters as an input and returns the SDK payload and the payment link. This also creates order in the Juspay system. > **Note** > For PIX PISP: `identity_credentials` field is a required field, this takes customer’s `cpf/cnpj` as input. For the PJ segment, cnpj along with cpf is mandatory. ### Step 2 Open HyperCheckout Screen Once the [Hypercheckout screen](https://juspay.io/br/docs/hypercheckout-global/web/base-sdk-integration/open-hypercheckout-screen) is opened, your users can proceed with the transactions. Opening Hypercheckout requires the SDK Payload from **Step 1** . The response of this should be forwarded to the Hypercheckout SDK in order to open the payment screen. Alternatively, payment link given in session api response can be launched directly in the browser that will handle the complete flow end to end. ### Step 3. Handle Payment Events Please follow the steps given [here](https://juspay.io/br/docs/hypercheckout-global/web/base-sdk-integration/handle-payment-response) to handle transaction response #### Code Snippets: - #### Java Code Snippet: ```java else if (event.equals("process_result")) { boolean error = jsonObject.optBoolean("error"); JSONObject innerPayload = jsonObject.optJSONObject("payload"); String status = innerPayload.optString("status"); if (!error) { switch (status) { case "charged": // Successful Transaction // check order status via S2S API redirect.putExtra("status", "OrderSuccess"); startActivity(redirect); break; case "cod_initiated": redirect.putExtra("status", "CODInitiated"); startActivity(redirect); break; } } else { switch (status) { case "backpressed": // user back-pressed from PP without initiating transaction break; case "user_aborted": // user initiated a txn and pressed back // check order status via S2S API Intent successIntent = new Intent(CheckoutActivity.this, ResponsePage.class); redirect.putExtra("status", "UserAborted"); startActivity(redirect); break; case "pending_vbv": redirect.putExtra("status", "PendingVBV"); startActivity(redirect); break; case "authorizing": // txn in pending state // check order status via S2S API redirect.putExtra("status", "Authorizing"); startActivity(redirect); break; case "authorization_failed": redirect.putExtra("status", "AuthorizationFailed"); startActivity(redirect); break; case "authentication_failed": redirect.putExtra("status", "AuthenticationFailed"); startActivity(redirect); break; case "api_failure": redirect.putExtra("status", "APIFailure"); startActivity(redirect); break; // txn failed // check order status via S2S API default: redirect.putExtra("status", "APIFailure"); startActivity(redirect); break; } } } ``` #### Kotlin Code Snippet: ```kotlin val error = jsonObject.optBoolean("error") val innerPayload = jsonObject.optJSONObject("payload") val status = innerPayload.optString("status") if (!error) { when (status) { "charged" -> { // Successful Transaction // check order status via S2S API redirect.putExtra("status", "OrderSuccess") startActivity(redirect) } "cod_initiated" -> { redirect.putExtra("status", "CODInitiated") startActivity(redirect) } } } else { when (status) { "backpressed" -> { } "user_aborted" -> { // user initiated a txn and pressed back // check order status via S2S API val successIntent = Intent( this@CheckoutActivity, ResponsePage::class.java ) redirect.putExtra("status", "UserAborted") startActivity(redirect) } "pending_vbv" -> { redirect.putExtra("status", "PendingVBV") startActivity(redirect) } "authorizing" -> { // txn in pending state // check order status via S2S API redirect.putExtra("status", "Authorizing") startActivity(redirect) } "authorization_failed" -> { redirect.putExtra("status", "AuthorizationFailed") startActivity(redirect) } "authentication_failed" -> { redirect.putExtra("status", "AuthenticationFailed") startActivity(redirect) } "api_failure" -> { redirect.putExtra("status", "APIFailure") startActivity(redirect) } } } ``` ### Step 4. Check Payment Status After receiving `process_result` from SDK, it is mandatory to do a Server-to-Server Order Status API call to determine the final payment status. Please ensure that you verify the order ID and amount transaction. To understand how to handle payment status on Juspay Hypercheckout, [refer to this section.](https://juspay.io/br/docs/hypercheckout-global/android/resources/transaction-status) #### Code Snippets: - #### Java Code Snippet: ```java else if (event.equals("process_result")) { boolean error = jsonObject.optBoolean("error"); JSONObject innerPayload = jsonObject.optJSONObject("payload"); String status = innerPayload.optString("status"); if (!error) { switch (status) { case "charged": // Successful Transaction // check order status via S2S API redirect.putExtra("status", "OrderSuccess"); startActivity(redirect); break; case "cod_initiated": redirect.putExtra("status", "CODInitiated"); startActivity(redirect); break; } } else { switch (status) { case "backpressed": // user back-pressed from PP without initiating transaction break; case "user_aborted": // user initiated a txn and pressed back // check order status via S2S API Intent successIntent = new Intent(CheckoutActivity.this, ResponsePage.class); redirect.putExtra("status", "UserAborted"); startActivity(redirect); break; case "pending_vbv": redirect.putExtra("status", "PendingVBV"); startActivity(redirect); break; case "authorizing": // txn in pending state // check order status via S2S API redirect.putExtra("status", "Authorizing"); startActivity(redirect); break; case "authorization_failed": redirect.putExtra("status", "AuthorizationFailed"); startActivity(redirect); break; case "authentication_failed": redirect.putExtra("status", "AuthenticationFailed"); startActivity(redirect); break; case "api_failure": redirect.putExtra("status", "APIFailure"); startActivity(redirect); break; // txn failed // check order status via S2S API default: redirect.putExtra("status", "APIFailure"); startActivity(redirect); break; } } } ``` #### Kotlin Code Snippet: ```kotlin val error = jsonObject.optBoolean("error") val innerPayload = jsonObject.optJSONObject("payload") val status = innerPayload.optString("status") if (!error) { when (status) { "charged" -> { // Successful Transaction // check order status via S2S API redirect.putExtra("status", "OrderSuccess") startActivity(redirect) } "cod_initiated" -> { redirect.putExtra("status", "CODInitiated") startActivity(redirect) } } } else { when (status) { "backpressed" -> { } "user_aborted" -> { // user initiated a txn and pressed back // check order status via S2S API val successIntent = Intent( this@CheckoutActivity, ResponsePage::class.java ) redirect.putExtra("status", "UserAborted") startActivity(redirect) } "pending_vbv" -> { redirect.putExtra("status", "PendingVBV") startActivity(redirect) } "authorizing" -> { // txn in pending state // check order status via S2S API redirect.putExtra("status", "Authorizing") startActivity(redirect) } "authorization_failed" -> { redirect.putExtra("status", "AuthorizationFailed") startActivity(redirect) } "authentication_failed" -> { redirect.putExtra("status", "AuthenticationFailed") startActivity(redirect) } "api_failure" -> { redirect.putExtra("status", "APIFailure") startActivity(redirect) } } } ``` ### Step 5. Display Payment Status Once the payment status is determined via the API, the final status should be displayed to the user. This screen needs to be handled by the merchant, it is not provided by the Hypercheckout SDK #### Code Snippets: - #### Java Code Snippet: ```java else if (event.equals("process_result")) { boolean error = jsonObject.optBoolean("error"); JSONObject innerPayload = jsonObject.optJSONObject("payload"); String status = innerPayload.optString("status"); if (!error) { switch (status) { case "charged": // Successful Transaction // check order status via S2S API redirect.putExtra("status", "OrderSuccess"); startActivity(redirect); break; case "cod_initiated": redirect.putExtra("status", "CODInitiated"); startActivity(redirect); break; } } else { switch (status) { case "backpressed": // user back-pressed from PP without initiating transaction break; case "user_aborted": // user initiated a txn and pressed back // check order status via S2S API Intent successIntent = new Intent(CheckoutActivity.this, ResponsePage.class); redirect.putExtra("status", "UserAborted"); startActivity(redirect); break; case "pending_vbv": redirect.putExtra("status", "PendingVBV"); startActivity(redirect); break; case "authorizing": // txn in pending state // check order status via S2S API redirect.putExtra("status", "Authorizing"); startActivity(redirect); break; case "authorization_failed": redirect.putExtra("status", "AuthorizationFailed"); startActivity(redirect); break; case "authentication_failed": redirect.putExtra("status", "AuthenticationFailed"); startActivity(redirect); break; case "api_failure": redirect.putExtra("status", "APIFailure"); startActivity(redirect); break; // txn failed // check order status via S2S API default: redirect.putExtra("status", "APIFailure"); startActivity(redirect); break; } } } ``` #### Kotlin Code Snippet: ```kotlin val error = jsonObject.optBoolean("error") val innerPayload = jsonObject.optJSONObject("payload") val status = innerPayload.optString("status") if (!error) { when (status) { "charged" -> { // Successful Transaction // check order status via S2S API redirect.putExtra("status", "OrderSuccess") startActivity(redirect) } "cod_initiated" -> { redirect.putExtra("status", "CODInitiated") startActivity(redirect) } } } else { when (status) { "backpressed" -> { } "user_aborted" -> { // user initiated a txn and pressed back // check order status via S2S API val successIntent = Intent( this@CheckoutActivity, ResponsePage::class.java ) redirect.putExtra("status", "UserAborted") startActivity(redirect) } "pending_vbv" -> { redirect.putExtra("status", "PendingVBV") startActivity(redirect) } "authorizing" -> { // txn in pending state // check order status via S2S API redirect.putExtra("status", "Authorizing") startActivity(redirect) } "authorization_failed" -> { redirect.putExtra("status", "AuthorizationFailed") startActivity(redirect) } "authentication_failed" -> { redirect.putExtra("status", "AuthenticationFailed") startActivity(redirect) } "api_failure" -> { redirect.putExtra("status", "APIFailure") startActivity(redirect) } } } ``` ## **FAQs** ## FAQs: ### What is the PIX Redirect flow via Open Finance? This flow allows users to initiate a Pix payment by redirecting them to their financial institution, where they authenticate and approve the payment using their bank's app or website. ### Does the user need to enroll or register in advance? No prior enrolment is required. The user only needs to authenticate and authorize the payment during the session via their bank. ### Is redirection required in every transaction? Yes. Since the user authorizes each payment within the bank's environment, redirection is a core part of the flow. ### Is user consent required for each payment? Yes. Under Open Finance, each payment requires explicit consent from the user, typically given during the redirection to their bank. ### Can we pre-select a user’s bank or restrict the list of available banks? No. Open Finance mandates that all available participant institutions be displayed to the user. Restricting or pre-selecting banks is not supported. ### What happens if the user abandons the flow or does not complete payment at the bank? The transaction will remain in a pending state until timeout, after which it is marked as failed or expired.  ### Are there limits to how much can be paid via this flow? Yes. Limits are determined by the user’s bank and their personal pix settings (e.g., per transaction and daily caps). Merchants should surface appropriate error messages if limits are hit. ### Is it possible to retry a failed transaction? Yes. The merchant can offer a retry option by re-initiating the payment request and redirecting the user again. ### Do we need to integrate with each bank separately? No. Juspay abstracts bank-level integrations and provides a unified API layer across all Open Finance participants. ### How do we handle timeouts or incomplete payments? Set up proper polling or webhook handling to detect if the user did not complete the payment.