Kaardid (Visa ja Mastercard)

Ülevaade

Võtke vastu krediit- ja deebetkaardimakseid Cost+ API kaudu, kasutades makseviisi credit-card.

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

Toetatud kaardibränded

Bränd	Tüüp
Amex	Krediit
Mastercard	Krediit / Deebet
Maestro	Deebet
Visa	Krediit / Deebet
V Pay	Deebet

Seadistamisvalikud

Dünaamiline kirjeldaja

Kasutage välja dynamic_descriptor, et määrata kohandatud väljavõtte tekst, mis kuvatakse kliendi panga- või kaardiväljavõttel.

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

Kliendi nime kasutamine kaardivaldaja nimena

Määrake use_customer_name_as_cardholder_name väärtuseks true, et automaatselt kasutada tellimuse kliendi nime kaardivaldaja nimena.

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

Kohandatud kaardisisestuse vorm

Kui soovite luua oma kaardisisestuse vormi hostitud makselehe asemel, järgige neid nelja sammu.

1. samm: Looge tellimus seadistustokeniga

Looge tellimus ja lisage tehingu payment_method_details objekti setup_token: true. See ütleb Cost+-ile, et genereerida seadistustoken, mida saate kaardi andmete turvaliseks tokeniseerimiseks kasutada.

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

Vastus sisaldab setup_token väärtust tehingu payment_method_details objektis:

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

2. samm: Tokeniseerige kaardi andmed

Saatke kaardi PAN, aegumiskuupäev ja seadistustoken tokeni lõpp-punkti. See salvestab kaardi turvaliselt ja tagastab 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..."
  }'

Vastus:

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

3. samm: Autentimine tehing

Esitage vault_token ja cvc autentimise lõpp-punkti. Kui 3D Secure on nõutud, saate redirect_url, kuhu klient oma panga autentimislehele suunata.

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

Vastus:

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

Suunake klient redirect_url-ile 3D Secure autentimise lõpuleviimiseks. Pärast autentimise lõpetamist (või tühistamist) suunatakse klient tagasi teie return_url-ile.

4. samm: Küsitlege tellimuse olekut

Pärast kliendi naasmist 3D Secure'ist küsitlege tellimust, et kontrollida lõplikku olekut.

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

Tellimuse status muutub üheks järgmistest:

Olek	Tähendus
`completed`	Makse oli edukas
`cancelled`	Klient tühistas või autentimine ebaõnnestus
`error`	Töötlemisel tekkis viga
`expired`	Tellimus aegus enne lõpuleviimist

Käsitsi autoriseerimise ja hõivamise voogude kohta kaardimaksetega vaadake juhendit Autoriseerimine / hõivamine / tühistamine.

On this page