Payment Expiry Time
Payment expiration times dictate how long a payment request remains valid before it automatically expires, and this can vary depending on the payment method used. Understanding these expiry times is crucial for planning your payment processes and ensuring timely transactions.
Default Expiry Time
Below are the default expiry times for each payment method. These times reflect the duration before a payment request expires if not completed by the customer:
| Payment Method | Partner | Deafult Expiry Time |
|---|---|---|
| Virtual Account | All Banks | 24 Hours |
| QRIS | 1 Hour | |
| E-Wallet | OVO | 5 minutes |
| E-Wallet | LinkAja | 5 minutes |
| E-Wallet | ShopeePay | 1 Hour |
| Card Payment | Credit Card | 1 Hour |
| Retail Store | Alfamart | 24 Hours |
| Bank Transfer | All Banks | 24 Hours |
The default expiry time applies only to Flow 1 or 2 integrations, or to Flow 3 if the expired_date is not specified.
Custom Expiry Time
For businesses requiring flexibility, we offer the ability to set custom expiry times for certain payment channels. This feature is available only for the following:
- QRIS
- Virtual Account (VA)
To enable custom expiry settings, your integration must follow Flow 3. You can set the expired_date in Create Bill request API. Below is the sample request for Flow 3 integration using custom expiry time :
- Virtual Account
- QRIS
The sample request if you use VA with custom expiry time.
curl -L 'https://bigflip.id/big_sandbox_api/v2/pwf/bill' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Accept: application/json' \
-d 'title=Test Payment QRIS' \
-d 'type=SINGLE' \
-d 'amount=45000' \
-d 'expired_date=2024-10-20 23:59' \
-d 'step=3' \
-d 'sender_name=test' \
-d 'sender_email=testdummy@gmail.com' \
-d 'sender_bank=mandiri' \
-d 'sender_bank_type=virtual_account'
The sample request if you use QRIS with custom expiry time.
curl -L 'https://bigflip.id/big_sandbox_api/v2/pwf/bill' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Accept: application/json' \
-d 'title=Test Payment VA' \
-d 'type=SINGLE' \
-d 'amount=50000' \
-d 'expired_date=2024-10-20 23:59' \
-d 'step=3' \
-d 'sender_name=test' \
-d 'sender_email=testdummy@gmail.com' \
-d 'sender_bank=qris' \
-d 'sender_bank_type=wallet_account'