Can refunds (returns) be made multiple times?

For refunds, use Refund a payment (POST: /v2/refunds), and multiple refunds are possible. However, there is a maximum limit of 50 times. Please note that the maximum number may change. If the limit is exceeded, the error code "REFUND_LIMIT_EXCEEDED" will be returned.

For details on the status transitions during refunds, please check here.

Also, if you execute Get payment details (GET: /v2/payments{merchantPaymentId}) on a payment for which Refund a payment has been executed even once, the status value returned at the time of return will be "REFUNDED" even if there is a refundable amount remaining.

If multiple refunds have been made but the refund (return) does not occur

It is possible that the refund was made with the same merchantRefundId.
When making multiple refunds, please set a different merchantRefundId for each refund.

Response Sample

"data": {
　　　　・
        "refunds": {
            "data": [
                {
                    "status": "REFUNDED",
                    "acceptedAt": 1665127741,
                    "merchantRefundId": "ddSand20221007_refund01",
                    "paymentId": "04002752470258507776",
                    "amount": {
                        "amount": 1000,
                        "currency": "JPY"
                    },
                    "requestedAt": 1587534300,
                    "reason": "test"
                },
                {
                    "status": "REFUNDED",
                    "acceptedAt": 1665127778,
                    "merchantRefundId": "ddSand20221007_refund02",
                    "paymentId": "04002752470258507776",
                    "amount": {
                        "amount": 500,
                        "currency": "JPY"
                    },
                    "requestedAt": 1587534300,
                    "reason": "test"
                }
            ]
        },
　　　・ 
}