Cost+Docs

Karty (Visa a Mastercard)

Prijimajte platby kreditnymi a debitnymi kartami

Prehlad

Prijimajte platby kreditnymi a debitnymi kartami cez Cost+ API pomocou platobnej metody credit-card.

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

Podporovane znacky kariet

ZnackaTyp
AmexKreditna
MastercardKreditna / Debetna
MaestroDebetna
VisaKreditna / Debetna
V PayDebetna

Moznosti konfiguracii

Dynamicky deskriptor

Pouzite pole dynamic_descriptor na nastavenie vlastneho textu, ktory sa zobrazi na bankovom vypise zakaznika.

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

Pouzitie mena zakaznika ako meno drzitela karty

Nastavte use_customer_name_as_cardholder_name na true pre automaticke pouzitie mena zakaznika z objednavky ako meno drzitela karty.

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

Vlastny formular na zadanie karty

Ak chcete vytvorit vlastny formular na zadanie karty namiesto pouzitia hostovanej platobnej stranky, postupujte podla tychto styroch krokov.

Krok 1: Vytvorenie objednavky s nastavovacim tokenom

Vytvorte objednavku a zahrnte setup_token: true v payment_method_details transakcie. To povie Cost+, aby vygenerovalo nastavovaci token, ktory mozete pouzit na bezpecnu tokenizaciu udajov karty.

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"
  }'

Odpoved bude obsahovat hodnotu setup_token v payment_method_details transakcie:

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

Krok 2: Tokenizacia udajov karty

Posliete PAN karty, datum exspiracie a nastavovaci token na endpoint tokenov. Toto bezpecne ulozi kartu a vrati 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..."
  }'

Odpoved:

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

Krok 3: Autentifikacia transakcie

Odosliete vault_token a cvc na endpoint autentifikacie. Ak je vyzadovany 3D Secure, dostavate redirect_url na presmerovanie zakaznika na autentifikacnu stranku jeho banky.

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"
  }'

Odpoved:

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

Presmerujte zakaznika na redirect_url na dokoncenie 3D Secure autentifikacie. Po dokonceni (alebo zruseni) autentifikacie bude zakaznik presmerovany spat na vasu return_url.

Krok 4: Dotazovanie na stav objednavky

Po navrate zakaznika z 3D Secure sa dotazujte na objednavku, aby ste skontrolovali konecny stav.

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

Stav objednavky status prejde do jedneho z:

StavVyznam
completedPlatba bola uspesna
cancelledZakaznik zrusil alebo autentifikacia zlyhala
errorPocas spracovania nastala chyba
expiredObjednavka vyprsala pred dokoncenim

Pre manualne autorizacne a zachytavacie procesy s kartovymi platbami pozrite navod Autorizacia / Zachytenie / Zrusenie.

On this page