Cost+Docs

Kartice (Visa & Mastercard)

Prihvaćajte plaćanja kreditnim i debitnim karticama

Pregled

Prihvaćajte plaćanja kreditnim i debitnim karticama putem Cost+ API-ja koristeći credit-card način plaćanja.

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

Podržani brendovi kartica

BrendTip
AmexKreditna
MastercardKreditna / Debitna
MaestroDebitna
VisaKreditna / Debitna
V PayDebitna

Opcije konfiguracije

Dinamički deskriptor

Koristite polje dynamic_descriptor za postavljanje prilagođenog teksta izvoda koji se pojavljuje na bankovnom ili kartičnom izvodu vašeg kupca.

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

Korištenje imena kupca kao imena vlasnika kartice

Postavite use_customer_name_as_cardholder_name na true za automatsko korištenje imena kupca iz narudžbe kao imena vlasnika kartice.

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

Prilagođeni obrazac za unos kartice

Ako želite izgraditi vlastiti obrazac za unos kartice umjesto korištenja hosted stranice za plaćanje, slijedite ova četiri koraka.

Korak 1: Stvorite narudžbu s setup tokenom

Stvorite narudžbu i uključite setup_token: true u payment_method_details transakcije. Ovo govori Cost+ da generira setup token koji možete koristiti za sigurnu tokenizaciju podataka kartice.

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 će sadržavati vrijednost setup_token u 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šaljite PAN kartice, datum isteka i setup token na krajnju točku za tokenizaciju. Ovo sigurno pohranjuje karticu i vraća 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: Autentificirajte transakciju

Pošaljite vault_token i cvc na krajnju točku za autentifikaciju. Ako je potreban 3D Secure, primit ćete redirect_url za preusmjeravanje kupca na stranicu za autentifikaciju njegove 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=..."
}

Preusmjerite kupca na redirect_url za dovršetak 3D Secure autentifikacije. Nakon što kupac dovrši (ili odustane od) autentifikacije, bit će preusmjeren natrag na vaš return_url.

Korak 4: Provjerite status narudžbe

Nakon što se kupac vrati s 3D Secure, provjerite narudžbu kako biste vidjeli konačni status.

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

Status narudžbe prijeći će u jedan od:

StatusZnačenje
completedPlaćanje je uspjelo
cancelledKupac je odustao ili autentifikacija nije uspjela
errorDošlo je do greške tijekom obrade
expiredNarudžba je istekla prije dovršetka

Za tijekove ručne autorizacije i naplate s kartičnim plaćanjima, pogledajte vodič Autorizacija / Naplata / Poništenje.

On this page