Skip to content

Autoryzacja

Info

Ten typ transakcji jest dostępny dla: Kart płatniczych.

Wybierz autoryzowany przepływ, jeśli chcesz obciążyć klienta (w całości lub częściowo) tylko przy dostawie lub świadczeniu towarów i usług. Takie podejście zapewnia, że płatności są przetwarzane w synchronizacji z realizacją zamówień.

Przepływ ten przypomina przepływ „jednorazowego zakupu”, pomijając dodatkowy etap przechwytywania płatności klienta za dostarczone towary lub usługi.

Przed rozpoczęciem

Stwórz zamówenie z wymaganymi danymi i zapewnij następujące informacje:

  • Uwzględnij typ płatności, kwotę, walutę i dozwolone metody płatności.
  • Jeśli wymagana jest tylko płatność kartą, na liście transaction.paymentMethod należy umieścić tylko „CARD”.
  • Sprawdź, czy transaction.paymentType ma wartość „AUTH”.

Generowanie transakcji

Należy pamiętać, że poniższe żądanie wymaga nagłówka autoryzacji z transactionSignature zwróconym z operacji checkout’cie.

W zapytaniu, Bearer Token jest zastępowany odpowiedzią checkout’u transactionSignature.

Path id

ścieżka

Obowiązkowy

Element do zapytania o status transakcji według identyfikatora transakcji.

Show more
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
cardInfo

object

Mandatory

Object that defines the payment operation request fields.

Show more
PAN

string <= 40 characters

Optional

The Primary Account Number (credit card number).

Show more
secureCode

string <= 40 characters

Optional

The security code (CVV/CVC) associated with the credit card.

Show more
validationDate

ISODateTime

Mandatory

The expiration date of the credit card.

Show more
cardholderName

string

Mandatory

The name of the cardholder as it appears on the credit card.

Show more
createToken

boolean

Mandatory

A flag indicating whether to create a token for future use or not (true/false).

Show more
Oto przykład:
{
    "cardInfo": {
        "PAN": "5236410030000927",
        "secureCode": "776",
        "validationDate": "2026-05-26T00:00:00.000Z",
        "cardholderName": "Jane Smith",
        "createToken": false
    }
}
Oczekiwana odpowiedź:

Pomyślna odpowiedź techniczna składa się ze statusu HTTP-200 i wartości returnStatus.statusCode=”000″.

PaymentStatus w odpowiedzi informuje o tym, czy sama transakcja została zaakceptowana, odrzucona, nadal oczekuje na ostateczny wynik lub wymaga podjęcia dodatkowych działań.

  • Success: Autoryzacja została pomyślnie przetworzona, a środki klienta zostały zweryfikowane.
  • Declined: Zezwolenie zostało odrzucone.
  • Pending: Ostateczny wynik autoryzacji nie jest jeszcze znany. Będziesz musiał sprawdzać status tej transakcji, dopóki nie osiągnie ona ostatecznego stanu lub nie zdecydujesz się jej anulować.
  • Partial: Autoryzacja została częściowo zaakceptowana, ale wymaga wykonania dodatkowych czynności (np. autentykacja 3D-Secure ). Element actionResponse zawiera instrukcje dotyczące dalszego postępowania.