Kártyák (Visa és Mastercard)

Áttekintés

Fogadjon el hitel- és betéti kártyás fizetéseket a Cost+ API-n keresztül a credit-card fizetési mód használatával.

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

Támogatott kártyamárkák

Márka	Típus
Amex	Hitelkártya
Mastercard	Hitel- / Betéti kártya
Maestro	Betéti kártya
Visa	Hitel- / Betéti kártya
V Pay	Betéti kártya

Konfigurációs lehetőségek

Dinamikus leíró

Használja a dynamic_descriptor mezőt egyéni kivonat-szöveg beállításához, amely megjelenik az ügyfél banki vagy kártyakivonatán.

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

Ügyfél nevének használata kártyabirtokos névként

Állítsa a use_customer_name_as_cardholder_name értéket true-ra az ügyfél nevének automatikus használatához a rendelésből mint kártyabirtokos név.

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

Egyéni kártyabeviteli űrlap

Ha saját kártyabeviteli űrlapot szeretne készíteni a tárolt fizetési oldal használata helyett, kövesse az alábbi négy lépést.

1. lépés: Rendelés létrehozása beállítási tokennel

Hozzon létre rendelést, és adja meg a setup_token: true értéket a tranzakció payment_method_details részében. Ez utasítja a Cost+-t egy beállítási token generálására, amellyel biztonságosan tokenizálhatja a kártyaadatokat.

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

A válasz tartalmazza a setup_token értéket a tranzakció payment_method_details részében:

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

2. lépés: Kártyaadatok tokenizálása

Küldje el a kártya PAN-ját, lejárati dátumát és a beállítási tokent a token végpontra. Ez biztonságosan tárolja a kártyát és visszaad egy vault_token-t.

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

Válasz:

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

3. lépés: Tranzakció hitelesítése

Küldje el a vault_token-t és a cvc-t a hitelesítési végpontra. Ha 3D Secure szükséges, egy redirect_url-t kap, ahová átirányíthatja az ügyfelet a bank hitelesítési oldalára.

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

Válasz:

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

Irányítsa át az ügyfelet a redirect_url címre a 3D Secure hitelesítés befejezéséhez. Miután az ügyfél befejezi (vagy megszakítja) a hitelesítést, visszairányítjuk az Ön return_url címére.

4. lépés: Rendelés állapotának lekérdezése

Miután az ügyfél visszatér a 3D Secure-ból, kérdezze le a rendelést a végleges állapot ellenőrzéséhez.

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

A rendelés status az alábbiak egyikére vált:

Állapot	Jelentés
`completed`	A fizetés sikeres volt
`cancelled`	Az ügyfél megszakította vagy a hitelesítés sikertelen
`error`	Hiba történt a feldolgozás során
`expired`	A rendelés lejárt a befejezés előtt

A kártyás fizetések manuális engedélyezési és rögzítési folyamataihoz lásd az Engedélyezés / Rögzítés / Érvénytelenítés útmutatót.

On this page