Patobulinome, kaip nepavykę SEB Open Banking (OB) grąžinimai atvaizduojami tiek prekybininko portale (Merchant Portal), tiek API, kad būtų lengviau nustatyti grąžinimo problemas ir spręsti nepavykusius grąžinimo bandymus.
Anksčiau, kai SEB Open Banking grąžinimas nepavykdavo, buvo rodomas tik bendras statusas Failed.
Įdiegus šį patobulinimą, kiekvienas nepavykęs grąžinimas dabar apima:
skaitinį klaidos kodą (error code)
aprašomąjį klaidos pranešimą (error message)
Ši informacija pasiekiama tiek prekybininko portale, tiek API.
Grąžinimų klaidų kodai
Nepavykus SEB Open Banking grąžinimams, gali būti grąžinami šie klaidų kodai:
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. |
Prekybininko portalas (Merchant Portal)
Peržiūrint mokėjimą prekybininko portale, skiltyje Transactions dabar rodomas atitinkamas klaidos kodas ir klaidos pranešimas kiekvienam nepavykusiam Refund sandoriui.
Tai leidžia greitai nustatyti, kodėl grąžinimo nepavyko atlikti.
API
Atsakymas GET /v4/payments/{payment_reference} buvo papildytas papildoma informacija apie grąžinimus.
Pervadintas laukas: last_refund_transaction
Laukas last_refund buvo pervadintas į last_refund_transaction.
Šiame objekte pateikiama informacija apie naujausią grąžinimo bandymą, įskaitant klaidos informaciją, jei grąžinimas nepavyko.
"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"
}
}
Naujas laukas: refund_transactions
Pridėtas naujas masyvas refund_transactions.
Šiame masyve pateikiami visi su mokėjimu susiję Open Banking grąžinimo bandymai, suteikiant pilną grąžinimo sandorių istoriją ir jų rezultatus.
"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"
}
}
]
Būtinas veiksmas
Ši skiltis aktuali tik tuo atveju, jei integruojatės tiesiogiai su API. Jei naudojate tik prekybininko portalą, jokių papildomų veiksmų atlikti nereikia.
Jei jūsų integracija šiuo metu naudoja lauką last_refund, atnaujinkite jį į pervadintą lauką last_refund_transaction.
Norėdami peržiūrėti pilną mokėjimo grąžinimo bandymų istoriją, taip pat rekomenduojame naudoti naują masyvą refund_transactions.