Skip to content

Zwrot

Celem tej operacji jest zwrot kwoty poprzedniej płatności, uznanie rachunku posiadacza karty i obciążenie rachunku sprzedawcy.

Zwrot jest wykonywany w odniesieniu do poprzedniej płatności, odwołując się do jej identyfikatora transakcji poprzez wysłanie żądania POST przez HTTPS do punktu końcowego /payments/{transactionID}/refund.

Zwrot może zostać wykonany:

  • Dla zakupu (PURS)
  • Dla przechwyconej preautoryzacji (AUTH -> Capture).

I może być:

  • Pełnym zwrotem pieniędzy, gdy całkowita kwota zakupu zostanie zwrócona posiadaczowi karty.
  • Częściowym zwrotem, gdy posiadaczowi karty zwracana jest suma częściowa całkowitego zakupu.
Wygeneruj transakcję:
POST https://stargate-cer.qly.site1.sibs.pt/api/v1/payments/{transactionID}/refund
Parametry nagłówka
Content-type

string

Mandatory

application/json

Show more
Authorization

string

Mandatory

Bearer Token. Based on OAuth2 authentication performed in a pre-step.

Show more
x-ibm-client-id

string

Mandatory

Token that identifies a client organization. It is provided during onboarding process and must be used in every call.

Show more
Parametry żądania
merchant

objekt

Obowiązkowy

Opcjonalny element służący do sprawdzania statusu transakcji.

Show more
terminalID

Numeryczny [<= 10 znaków]

Obowiązkowy

Identyfikacja terminala handlowego

Show more
kanał

ścieżka

Obowiązkowy

Kanał sprzedawcy, możliwa wartość „Sieć”

Show more
merchantTransactionID

ścieżka

Obowiązkowy

Unikalny identyfikator używany przez sprzedawcę.

Show more
transakcja

objekt

Obowiązkowy

Opcjonalny element służący do sprawdzania statusu transakcji.

Show more
transactionTimeStamp

Date ISODate Time

Obowiązkowy

Znacznik czasu transakcji.

Show more
opis

ciąg <= 70 znaków

Obowiązkowy

Krótki opis transakcji.

Show more
amount
Obowiązkowy

Parametr określający wartość i walutę transakcji.

Show more
wartość

liczba Podwójna

Obowiązkowy

Kwota w transakcji.

Show more
waluta

Kod waluty
SO 4217 Alpha-3 Code

Obowiązkowy
Show more
originalTransaction
Obowiązkowy

Parametr z oryginalną transakcją.

Show more
Id

ścieżka

Obowiązkowy

Unikalny identyfikator pierwotnej transakcji.

Show more
data czas

data ISODate Time

Obowiązkowy

Znacznik czasu oryginalnej transakcji.

Show more

Oto przykład:

Nagłówek żądania:
Autorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6I (...)
X-IBM-Client-Id: b4480347-9fc8-4790-b359-100a99c60ea3
Content-Type: application/json
{
 "merchant": {
 "terminalId": 24,
 "channel": "web",
 "merchantTransactionId": "BO_Order Id: c9876bcasd"
 },
 "transaction": {
 "transactionTimestamp": "2022-05-29T18:23:41.367Z",
 "description": "This is a refund request",
 "amount": {
 "value": 10,
  "currency": "PLN"
 },
 "originalTransaction": {
 "id": "mvuy3dh3wucpsi4389fh",
 "datetime": "2022-05-29T17:23:36.105Z"
 }
 }
}