# Status

## Payment Session Statuses

<table><thead><tr><th width="181.94140625">Status</th><th width="194.7734375">Dashboard status wording</th><th width="184.4453125">Cancellable </th><th width="189.421875">Definition</th><th width="181.6328125">Action items</th></tr></thead><tbody><tr><td>REQUIRE_PAYMENT_METHOD</td><td>Waiting for payment method</td><td><p></p><p>✅ By Merchant &#x26; Customer</p><p></p><p>Possible values:</p><ul><li>REQUESTED_BY_CUSTOMER</li><li>DUPLICATED</li><li>VOID_SESSION</li></ul></td><td>When Merchant created payment session and waiting for user to choose payment method</td><td>Choose payment Method</td></tr><tr><td>REQUIRE_CONFIRMATION</td><td>Waiting for confirmation</td><td><p>✅ By Merchant &#x26; Customer</p><p></p><p>Possible values:</p><ul><li>REQUESTED_BY_CUSTOMER</li><li>DUPLICATED</li><li>VOID_SESSION</li></ul></td><td>After payment method is selected, waiting for the payment session to be confirmed and continue to charge process</td><td>Confirm</td></tr><tr><td>REQUIRE_ACTION</td><td>Waiting for user action</td><td>❌ For API method</td><td>Payment method (Charge) already initiated and Waiting for customer action</td><td><p></p><ul><li>Push Payment (VA &#x26; QR) = Customer to initiate transaction</li><li>Pull Payment (Card &#x26; Ewallet) = Customer to fill in details to be charged</li></ul></td></tr><tr><td>ACTIVE</td><td>Waiting for charged</td><td>❌</td><td><mark style="color:orange;"><code>Multiple</code></mark> use payment type is already Active and Waiting for customer action</td><td><p>Push Payment </p><p>(VA &#x26; QR) = Customer to initiate transaction</p></td></tr><tr><td>PROCESSING</td><td>Processing</td><td>❌</td><td>Payment already processed by partners, charge is confirmed and already initiate the payment process</td><td>Wait for callback</td></tr><tr><td><p>[Final Status]</p><p>CANCELLED</p></td><td>Cancelled</td><td>❌</td><td>Session cancelled by merchant / customer</td><td>Redirect to failed payment</td></tr><tr><td><p>[Final Status]</p><p>EXPIRED</p></td><td>Expired</td><td>❌</td><td>Customer exceed payment session time</td><td>Redirect to failed payment</td></tr><tr><td><p>[Final Status]</p><p>INACTIVE</p></td><td>Inactive</td><td>❌</td><td>Multiple use payment type is inactive</td><td>Create New Payment Session to generate  Payment Type = <mark style="color:orange;"><code>MULTIPLE</code></mark></td></tr><tr><td><p>[Final Status]</p><p>PAID</p></td><td>Paid</td><td>❌</td><td>Payment session successfully paid</td><td>Redirect to successful payment</td></tr></tbody></table>

## Charge Statuses

| Status                               | Definition                                                                                                                     | Action items                                                                                                                                                         |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| WAITING\_FOR\_USER\_ACTION           | Payment session is confirmed and waiting for customer to perform action                                                        | <p></p><ul><li>Push Payment (VA & QR) = Customer to initiate transaction</li><li>Pull Payment (Card & Ewallet) = Customer to fill in details to be charged</li></ul> |
| WAITING\_FOR\_AUTHENTICATION         | <p>Only applicable for pull payment</p><p>Waiting for partner to authenticate the transaction</p>                              | Input OTP or PIN                                                                                                                                                     |
| PROCESSING                           | Partner processing the transaction                                                                                             | Waiting for partner to complete the process                                                                                                                          |
| WAITING\_FOR\_CAPTURE                | <p>Only applicable for Cards and if autoCapture: false</p><p>Charge already authorized (money booked) but not captured yet</p> | Merchant to call Capture                                                                                                                                             |
| <p>\[Final Status]</p><p>FAILED</p>  | Charge failed                                                                                                                  | -                                                                                                                                                                    |
| <p>\[Final Status]</p><p>EXPIRED</p> | Charge expired                                                                                                                 | -                                                                                                                                                                    |
| <p>\[Final Status]</p><p>SUCCESS</p> | Charge is successful & completed                                                                                               | -                                                                                                                                                                    |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://pivot-payment.gitbook.io/pivot-docs/api-references/api-lists/payments/status.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
