Kortelės (Visa ir Mastercard)

Apžvalga

Priimkite kreditinių ir debetinių kortelių mokėjimus per Cost+ API naudodami credit-card mokėjimo būdą.

{
  "transactions": [
    {
      "payment_method": "credit-card"
    }
  ]
}

Palaikomi kortelių prekės ženklai

Prekės ženklas	Tipas
Amex	Kreditinė
Mastercard	Kreditinė / Debetinė
Maestro	Debetinė
Visa	Kreditinė / Debetinė
V Pay	Debetinė

Konfigūracijos parinktys

Dinaminis aprašas

Naudokite dynamic_descriptor lauką, kad nustatytumėte pasirinktinį tekstą, rodomą kliento banko ar kortelės išraše.

{
  "transactions": [
    {
      "payment_method": "credit-card",
      "payment_method_details": {
        "dynamic_descriptor": "My Store Order 123"
      }
    }
  ]
}

Kliento vardo naudojimas kaip kortelės turėtojo vardas

Nustatykite use_customer_name_as_cardholder_name kaip true, kad automatiškai būtų naudojamas kliento vardas iš užsakymo kaip kortelės turėtojo vardas.

{
  "transactions": [
    {
      "payment_method": "credit-card",
      "payment_method_details": {
        "use_customer_name_as_cardholder_name": true
      }
    }
  ]
}

Pasirinktinė kortelės duomenų įvedimo forma

Jei norite sukurti savo kortelės duomenų įvedimo formą vietoj mokėjimo puslapio naudojimo, atlikite šiuos keturis žingsnius.

1 žingsnis: Sukurkite užsakymą su nustatymo tokenu

Sukurkite užsakymą ir įtraukite setup_token: true operacijos payment_method_details. Tai nurodo Cost+ sugeneruoti nustatymo tokeną, kurį galite naudoti saugiam kortelės duomenų tokenizavimui.

curl -X POST https://api.costplus.online/v1/orders \
  -u your-api-key: \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "EUR",
    "amount": 5000,
    "merchant_order_id": "order-001",
    "transactions": [
      {
        "payment_method": "credit-card",
        "payment_method_details": {
          "setup_token": true
        }
      }
    ],
    "return_url": "https://example.com/return",
    "webhook_url": "https://example.com/webhook"
  }'

Atsakyme bus setup_token reikšmė operacijos payment_method_details:

{
  "id": "order-uuid",
  "transactions": [
    {
      "id": "txn-uuid",
      "payment_method": "credit-card",
      "payment_method_details": {
        "setup_token": "st_abc123..."
      }
    }
  ]
}

2 žingsnis: Tokenizuokite kortelės duomenis

Siųskite kortelės PAN, galiojimo datą ir nustatymo tokeną į tokeno galinį tašką. Tai saugiai išsaugo kortelę ir grąžina vault_token.

curl -X POST https://api.costplus.online/v1/tokens/ \
  -H "Content-Type: application/json" \
  -d '{
    "pan": "4111111111111111",
    "expiry_date": "1228",
    "setup_token": "st_abc123..."
  }'

Atsakymas:

{
  "vault_token": "vt_xyz789..."
}

3 žingsnis: Autentifikuokite operaciją

Pateikite vault_token ir cvc autentifikacijos galiniam taškui. Jei reikalingas 3D Secure, gausite redirect_url, kad nukreiptumėte klientą į jo banko autentifikacijos puslapį.

curl -X POST https://api.costplus.online/v1/orders/{order_id}/transactions/{transaction_id}/authenticate/ \
  -u your-api-key: \
  -H "Content-Type: application/json" \
  -d '{
    "vault_token": "vt_xyz789...",
    "cvc": "123"
  }'

Atsakymas:

{
  "redirect_url": "https://3ds.bank.example.com/auth?id=..."
}

Nukreipkite klientą į redirect_url, kad užbaigtų 3D Secure autentifikaciją. Klientui užbaigus (arba atšaukus) autentifikaciją, jis bus nukreiptas atgal į jūsų return_url.

4 žingsnis: Tikrinkite užsakymo būseną

Klientui grįžus iš 3D Secure, tikrinkite užsakymą, kad sužinotumėte galutinę būseną.

curl -X GET https://api.costplus.online/v1/orders/{order_id} \
  -u your-api-key:

Užsakymo status pereis į vieną iš:

Būsena	Reikšmė
`completed`	Mokėjimas sėkmingas
`cancelled`	Klientas atšaukė arba autentifikacija nepavyko
`error`	Apdorojimo metu įvyko klaida
`expired`	Užsakymo galiojimas baigėsi prieš užbaigimą

Rankiniam autorizacijos ir surinkimo procesui su kortelių mokėjimais žiūrėkite gidą Autorizacija / Surinkimas / Anuliavimas.

On this page