Esam uzlabojuši to, kā neveiksmīgas SEB Open Banking (OB) atmaksas tiek attēlotas gan tirgotāja portālā (Merchant Portal), gan API, atvieglojot atmaksas problēmu identificēšanu un neveiksmīgu atmaksas mēģinājumu risināšanu.
Iepriekš, ja SEB Open Banking atmaksa neizdevās, tika parādīts tikai vispārīgs statuss Failed.
Ar šo uzlabojumu katra neveiksmīga atmaksa tagad ietver:
skaitlisku kļūdas kodu (error code)
aprakstošu kļūdas ziņojumu (error message)
Šī informācija ir pieejama gan tirgotāja portālā, gan API.
Atmaksu kļūdu kodi
Šādi kļūdu kodi var tikt atgriezti neveiksmīgu SEB Open Banking atmaksu gadījumā:
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. |
Tirgotāja portāls (Merchant Portal)
Skatot maksājumu tirgotāja portālā, sadaļā Transactions tagad tiek attēlots atbilstošais kļūdas kods un kļūdas ziņojums jebkuram neveiksmīgam Refund darījumam.
Tas ļauj ātri noskaidrot, kāpēc atmaksu nebija iespējams veikt.
API
Atbilde GET /v4/payments/{payment_reference} ir papildināta ar papildu informāciju par atmaksām.
Pārdēvēts lauks: last_refund_transaction
Lauks last_refund ir pārdēvēts par last_refund_transaction.
Šis objekts satur informāciju par jaunāko atmaksas mēģinājumu, tostarp kļūdas informāciju, ja atmaksa neizdevās.
"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"
}
}
Jauns lauks: refund_transactions
Ir pievienots jauns masīvs refund_transactions.
Šis masīvs satur visus ar maksājumu saistītos Open Banking atmaksas mēģinājumus, nodrošinot pilnu atmaksas darījumu vēsturi un to rezultātus.
"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"
}
}
]
Nepieciešamā darbība
Šī sadaļa attiecas tikai uz gadījumiem, kad izmantojat tiešu integrāciju ar API. Ja izmantojat tikai tirgotāja portālu, papildu darbības nav nepieciešamas.
Ja jūsu integrācija pašlaik izmanto lauku last_refund, lūdzu, atjauniniet to, lai izmantotu pārdēvēto lauku last_refund_transaction.
Lai piekļūtu pilnai maksājuma atmaksas mēģinājumu vēsturei, iesakām izmantot arī jauno masīvu refund_transactions.