Cost+Docs

Kartice (Visa in Mastercard)

Sprejemajte plačila s kreditnimi in debetnimi karticami

Pregled

Sprejemajte plačila s kreditnimi in debetnimi karticami prek Cost+ API z uporabo plačilne metode credit-card.

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

Podprte blagovne znamke kartic

Blagovna znamkaTip
AmexKreditna
MastercardKreditna / Debetna
MaestroDebetna
VisaKreditna / Debetna
V PayDebetna

Možnosti konfiguracije

Dinamični deskriptor

Uporabite polje dynamic_descriptor za nastavitev besedila po meri, ki se prikaže na bančnem izpisku ali kartičnem izpisku stranke.

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

Uporaba imena stranke kot imena imetnika kartice

Nastavite use_customer_name_as_cardholder_name na true za samodejno uporabo imena stranke iz naročila kot imena imetnika kartice.

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

Obrazec za vnos kartice po meri

Če želite zgraditi lasten obrazec za vnos kartice namesto uporabe gostovane plačilne strani, sledite tem štirim korakom.

Korak 1: Ustvarite naročilo z nastavitvenim žetonom

Ustvarite naročilo in vključite setup_token: true v payment_method_details transakcije. To sporoči Cost+, da generira nastavitveni žeton, ki ga lahko uporabite za varno tokenizacijo kartičnih podatkov.

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

Odgovor bo vključeval vrednost setup_token v payment_method_details transakcije:

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

Korak 2: Tokenizirajte podatke kartice

Pošljite PAN kartice, datum veljavnosti in nastavitveni žeton na končno točko za žetone. To varno shrani kartico in vrne 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..."
  }'

Odgovor:

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

Korak 3: Avtenticirajte transakcijo

Pošljite vault_token in cvc na končno točko za avtentikacijo. Če je potrebna 3D Secure avtentikacija, boste prejeli redirect_url za preusmeritev stranke na avtentikacijsko stran njene banke.

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

Odgovor:

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

Preusmerite stranko na redirect_url za dokončanje 3D Secure avtentikacije. Po tem, ko stranka dokonča (ali prekliče) avtentikacijo, bo preusmerjena nazaj na vaš return_url.

Korak 4: Poizvedujte o statusu naročila

Po vrnitvi stranke iz 3D Secure poizvedujte o naročilu za preverjanje končnega statusa.

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

Status naročila se bo spremenil v enega od:

StatusPomen
completedPlačilo je bilo uspešno
cancelledStranka je preklicala ali avtentikacija ni uspela
errorMed obdelavo je prišlo do napake
expiredNaročilo je poteklo pred dokončanjem

Za ročne tokove avtorizacije in zajema s kartičnimi plačili glejte vodnik Avtorizacija / zajem / razveljavitev.

On this page