Oleme täiustanud viisi, kuidas ebaõnnestunud SEB Open Banking (OB) tagasimaksed kuvatakse nii kaupmehe portaalis (Merchant Portal) kui ka API-s, et hõlbustada tagasimaksete probleemide tuvastamist ja ebaõnnestunud tagasimaksekatsete lahendamist.
Varem kuvati ebaõnnestunud SEB Open Banking tagasimakse korral ainult üldine olek Failed.
Selle täiustuse tulemusena sisaldab iga ebaõnnestunud tagasimakse nüüd:
numbrilist veakoodi (error code)
kirjeldavat veateadet (error message)
See info on kättesaadav nii kaupmehe portaalis kui ka API-s.
Tagasimaksete veakoodid
Ebaõnnestunud SEB Open Banking tagasimaksete korral võidakse tagastada järgmised veakoodid:
Error Code | Error Message | Error Notes |
3501 | Payment rejected by bank | Generic bank rejection; used for RESOURCE_UNKNOWN errors and AM05 - Payment is a duplicate of another payment |
3508 | There is not enough available funds | Amount of funds available to cover specified message amount is insufficient |
3520 | Payment limit exceeded | Transaction amount exceeds limits agreed between bank and client |
3522 | Payment date is incorrect | Requested Execution Date or Requested Collection Date is too far in the past |
3541 | Payment cannot be refunded at this time, please try again | Error may appear when refund was initiated before the funds had been credited to the account. Please check that the payment has been received in your account and initiate the refund only after the funds are available. |
3542 | Payment is not refundable, please contact your bank |
|
3999 | Unexpected error / Unknown Processor Response Code | Fallback for any unmapped or unknown SEB error code. |
Kaupmehe portaal (Merchant Portal)
Makset kaupmehe portaalis vaadates kuvatakse jaotises Transactions nüüd vastav veakood ja veateade iga ebaõnnestunud Refund tehingu juures.
See võimaldab kiiresti tuvastada, miks tagasimakset ei olnud võimalik teostada.
API
Vastust GET /v4/payments/{payment_reference} on täiendatud lisainfoga tagasimaksete kohta.
Ümbernimetatud väli: last_refund_transaction
Väli last_refund on ümber nimetatud väljaks last_refund_transaction.
See objekt sisaldab viimase tagasimaksekatse andmeid, sealhulgas veainfot, kui tagasimakse ebaõnnestus.
"last_refund_transaction": {
"status": "failed",
"amount": 0.01,
"timestamp": "2026-04-21T08:49:20Z",
"errors": {
"code": 3541,
"message": "Payment cannot be refunded at this time, please try again",
"endpoint": "/v1/refunds"
}
}}
Uus väli: refund_transactions
Lisatud on uus massiiv refund_transactions.
See massiiv sisaldab kõiki maksega seotud Open Banking tagasimaksekatseid, andes täieliku ülevaate tagasimaksetehingute ajaloost ja tulemustest.
json
"refund_transactions": [
{
"status": "failed",
"amount": 0.01,
"timestamp": "2026-04-19T08:11:00Z",
"errors": {
"code": 3508,
"message": "There is not enough available funds",
"endpoint": "/v1/refunds"
}
},
{
"status": "failed",
"amount": 0.01,
"timestamp": "2026-04-21T08:49:20Z",
"errors": {
"code": 3501,
"message": "Payment rejected by bank",
"endpoint": "/v1/refunds"
}
}
]
Vajalik tegevus
See jaotis kehtib ainult juhul, kui integreerite otse API-ga. Kui kasutate ainult kaupmehe portaali, siis täiendavaid toiminguid ei ole vaja teha.
Kui teie integratsioon kasutab praegu välja last_refund, palun uuendage see ümbernimetatud väljale last_refund_transaction.
Maksega seotud tagasimaksekatsete täieliku ajaloo nägemiseks soovitame kasutada ka uut massiivi refund_transactions.