Skip to content

Anulowanie

Info

Ten rodzaj transakcji jest dostępny dla: Kart, BLIK i PayByLink.

Anulowanie odbywa się na podstawie poprzedniej autoryzacji płatności (AUTH) poprzez odniesienie do jej identyfikatora transakcji i wysłanie żądania POST przez HTTPS do punktu końcowego /payments/{transactionID}/cancellation.

W przypadku anulowania płatności, jeśli została wysłana w określonym terminie, autoryzacja nie została jeszcze przechwycona, anulowanie powoduje wysłanie do wydawcy karty żądania cofnięcia autoryzacji w celu rozliczenia środków zgromadzonych na podstawie autoryzacji.

Może to być anulowanie całkowite, gdy sprzedawca anuluje całą kwotę autoryzacji, lub częściowe, gdy sprzedawca anuluje sumę częściową całkowitej autoryzacji.

Możliwość anulowania zakupu BLIK jest dostępna tylko do momentu osiągnięcia przez transakcję statusu końcowego, co następuje w momencie otrzymania przez Stargate potwierdzenia BLIK.

Wygeneruj transakcję:
POST https://stargate-cer.qly.site1.sibs.pt/api/v1/payments/{transactionID}/cancellation
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 zapytania
Merchant

object

Mandatory

An optional element to query transaction status.

Show more
TerminalID

numeric [<= 10 characters]

Mandatory

Merchant Terminal Identification.

Show more
Channel

string

Mandatory

Merchant channel, Possible Value “Web”.

Show more
merchantTransactionID

string

Mandatory

Unique Id used by the Merchant.

Show more
Transaction

object

Mandatory

An optional element to query transaction status.

Show more
transactionTimeStamp

Date ISODate Time

Mandatory

Transaction timestamp.

Show more
Description

string <= 70 characters

Mandatory

Transaction short description.

Show more
amount
Mandatory

Parameter with the value and currency of the transaction.

Show more
Value

number Double

Mandatory

Amount in the transaction.

Show more
Currency

Currency Code
SO 4217 Alpha-3 Code

Mandatory
Show more
originalTransaction
Mandatory

Parameter with the original transaction.

Show more
Id

string

Mandatory

Unique identifier of the original transaction.

Show more
Date time

date ISODate Time

Mandatory

Timestamp of the original transaction.

Show more

Oto przykład wiadomości o anulowaniu:

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 cancellation request",
 "amount": {
 "value": 5,
 "currency": "PLN"
 },
 "originalTransaction": {
 "id": "1ach2CGpZ2BAKUfqJ9Rp",
 "datetime": "2022-05-29T17:23:36.105Z"
 }
 }
}