Kartes (Visa un Mastercard)

Pārskats

Pieņemiet kredītkaršu un debetkaršu maksājumus caur Cost+ API, izmantojot credit-card maksājumu metodi.

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

Atbalstītie karšu zīmoli

Zīmols	Tips
Amex	Kredītkarte
Mastercard	Kredītkarte / Debetkarte
Maestro	Debetkarte
Visa	Kredītkarte / Debetkarte
V Pay	Debetkarte

Konfigurācijas opcijas

Dinamiskais deskriptors

Izmantojiet dynamic_descriptor lauku, lai iestatītu pielāgotu paziņojuma tekstu, kas parādās klienta bankas vai kartes izrakstā.

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

Izmantot klienta vārdu kā kartes turētāja vārdu

Iestatiet use_customer_name_as_cardholder_name uz true, lai automātiski izmantotu klienta vārdu no pasūtījuma kā kartes turētāja vārdu.

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

Pielāgota kartes ievades forma

Ja vēlaties izveidot savu kartes ievades formu, nevis izmantot mitināto maksājuma lapu, izpildiet šos četrus soļus.

1. solis: Izveidojiet pasūtījumu ar iestatīšanas tokenu

Izveidojiet pasūtījumu un iekļaujiet setup_token: true darījuma payment_method_details. Tas norāda Cost+ ģenerēt iestatīšanas tokenu, ko varat izmantot, lai droši tokenizētu kartes datus.

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

Atbilde ietvers setup_token vērtību darījuma payment_method_details:

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

2. solis: Tokenizējiet kartes datus

Nosūtiet kartes PAN, derīguma termiņu un iestatīšanas tokenu uz tokenu galapunktu. Tas droši saglabā karti un atgriež 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..."
  }'

Atbilde:

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

3. solis: Autentificējiet darījumu

Iesniedziet vault_token un cvc autentifikācijas galapunktam. Ja ir nepieciešams 3D Secure, jūs saņemsiet redirect_url, lai novirzītu klientu uz viņa bankas autentifikācijas lapu.

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

Atbilde:

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

Novirziet klientu uz redirect_url, lai pabeigtu 3D Secure autentifikāciju. Pēc tam, kad klients pabeidz (vai atceļ) autentifikāciju, viņš tiks novirzīts atpakaļ uz jūsu return_url.

4. solis: Aptaujājiet pasūtījuma statusu

Pēc klienta atgriešanās no 3D Secure aptaujājiet pasūtījumu, lai pārbaudītu galīgo statusu.

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

Pasūtījuma status pāries uz vienu no:

Statuss	Nozīme
`completed`	Maksājums bija veiksmīgs
`cancelled`	Klients atcēla vai autentifikācija neizdevās
`error`	Apstrādes laikā radās kļūda
`expired`	Pasūtījuma termiņš beidzās pirms pabeigšanas

Manuālai autorizācijai un iegūšanas plūsmām ar karšu maksājumiem skatiet Autorizācija / Iegūšana / Anulēšana pamācību.

On this page