Karty (Visa a Mastercard)

Přehled

Přijímejte platby kreditními a debetními kartami prostřednictvím API Cost+ pomocí platební metody credit-card.

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

Podporované kartové značky

Značka	Typ
Amex	Kreditní
Mastercard	Kreditní / Debetní
Maestro	Debetní
Visa	Kreditní / Debetní
V Pay	Debetní

Možnosti konfigurace

Dynamický popis

Použijte pole dynamic_descriptor pro nastavení vlastního textu, který se zobrazí na bankovním výpisu zákazníka.

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

Použití jména zákazníka jako jména držitele karty

Nastavte use_customer_name_as_cardholder_name na true pro automatické použití jména zákazníka z objednávky jako jména držitele karty.

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

Vlastní formulář pro zadání karty

Pokud chcete vytvořit vlastní formulář pro zadání karty namísto použití hostované platební stránky, postupujte podle těchto čtyř kroků.

Krok 1: Vytvoření objednávky s setup tokenem

Vytvořte objednávku a zahrňte setup_token: true v payment_method_details transakce. To říká Cost+, aby vygeneroval setup token, který můžete použít k bezpečné tokenizaci údajů 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"
  }'

Odpověď bude obsahovat hodnotu setup_token v payment_method_details transakce:

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

Krok 2: Tokenizace údajů karty

Odešlete PAN karty, datum platnosti a setup token na endpoint pro tokeny. Tím se karta bezpečně uloží a vrátí se 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..."
  }'

Odpověď:

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

Krok 3: Autentizace transakce

Odešlete vault_token a cvc na endpoint pro autentizaci. Pokud je vyžadováno 3D Secure, obdržíte redirect_url pro přesměrování zákazníka na autentizační stránku 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"
  }'

Odpověď:

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

Přesměrujte zákazníka na redirect_url pro dokončení 3D Secure autentizace. Po dokončení (nebo zrušení) autentizace bude zákazník přesměrován zpět na vaši return_url.

Krok 4: Dotazování na stav objednávky

Po návratu zákazníka z 3D Secure se dotažte na objednávku pro zjištění konečného stavu.

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

Stav objednávky status přejde do jednoho z:

Stav	Význam
`completed`	Platba byla úspěšná
`cancelled`	Zákazník zrušil nebo autentizace selhala
`error`	Při zpracování došlo k chybě
`expired`	Objednávka vypršela před dokončením

Pro toky s manuální autorizací a zachycením u kartových plateb viz průvodce Autorizace / Zachycení / Zrušení.

On this page