Scenario
The Special Shop carries out regular fixed-amount credit card order transactions.
- ReAuth：When the latest periodic fixed-amount purchases authorization fails, you can reauthorize.
- Cancel：Cancel periodic fixed-amount purchases.
API URLS
- Stage：https://payment-stage.ecpay.com.tw/Cashier/CreditCardPeriodAction
- Production：https://payment.ecpay.com.tw/Cashier/CreditCardPeriodAction
HTTPS Transfer Protocol
- Content Type：application/x-www-form-urlencoded
- HTTP Method：POST
Merchant return parameter details
MerchantID String(10)
Required
MerchantTradeNo String(20)
Required
Merchant Transaction ID transmitted to ECPay when order was created.
Action String(20)
Required
- ReAuth：Re authorize
- Cancel：Cancel periodic fixed-amount purchases
TimeStamp Int
Required
- ECPay verification time interval is currently set to be under 3 minutes and interfacing will expire if time is exceeded.
- Reference: http://www.epochconverter.com/。
CheckMacValue String
Required
Please refer to the Appendix Checksum Mechanism.
Used by contracted platform merchants.
- For general merchants or platform merchant interfacing, please leave empty.
- For use by platform merchants, please set [MerchantID] as the parameter.
Special Note：
- The credit card is only available when the latest authorization for a transaction has failed, e.g. if the second authorization fails but the third one is successful, the second failed transaction cannot be re-authorised at that time.
- Once a deactivated transaction has been successfully completed, it cannot be re-activated and can only be done by re-initiating a new fixed term order.
Merchant return parameter description
A return value of 1 indicates successful authorization, while any other value indicates failure. For more information on error codes, please refer to the list of transaction status codes.
Special Note：A retroactive license transaction is scheduled to be sent to [PeriodReturnURL] by the system to send a notification of the result of the retroactive license.
Merchant Transaction ID transmitted to ECPay when order was created.
Please refer to the Appendix Checksum Mechanism.
Special Note：The shop must determine whether the check code [CheckMacValue] is correct and whether the payment notification for the order has been processed accordingly to avoid loss of synchronisation of the transaction status.