Kortit (Visa ja Mastercard)

Yleiskatsaus

Vastaanota luotto- ja pankkikorttimaksuja Cost+ API:n kautta käyttäen credit-card-maksutapaa.

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

Tuetut korttibrändit

Brändi	Tyyppi
Amex	Luotto
Mastercard	Luotto / Debit
Maestro	Debit
Visa	Luotto / Debit
V Pay	Debit

Asetukset

Dynaaminen kuvaus

Käytä dynamic_descriptor-kenttää asettaaksesi mukautetun tiliotetekstin, joka näkyy asiakkaan pankki- tai korttitiliotteessa.

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

Käytä asiakkaan nimeä kortinhaltijan nimenä

Aseta use_customer_name_as_cardholder_name arvoon true käyttääksesi automaattisesti tilauksen asiakkaan nimeä kortinhaltijan nimenä.

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

Mukautettu korttitietolomake

Jos haluat rakentaa oman korttitietolomakkeen isännöidyn maksusivun sijaan, noudata näitä neljää vaihetta.

Vaihe 1: Luo tilaus setup-tokenilla

Luo tilaus ja sisällytä setup_token: true tapahtuman payment_method_details-kenttään. Tämä kehottaa Cost+:aa luomaan setup-tokenin, jota voit käyttää korttitietojen turvalliseen tokenisointiin.

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

Vastaus sisältää setup_token-arvon tapahtuman payment_method_details-kentässä:

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

Vaihe 2: Tokenisoi korttitiedot

Lähetä kortin PAN, voimassaolopäivä ja setup-token token-päätepisteeseen. Tämä tallentaa kortin turvallisesti ja palauttaa vault_token-arvon.

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

Vastaus:

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

Vaihe 3: Todenna tapahtuma

Lähetä vault_token ja cvc todennuspäätepisteeseen. Jos 3D Secure vaaditaan, saat redirect_url-osoitteen, johon asiakas ohjataan pankin todennussivulle.

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

Vastaus:

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

Ohjaa asiakas redirect_url-osoitteeseen 3D Secure -todennuksen suorittamiseksi. Todennuksen suorittamisen (tai peruuttamisen) jälkeen asiakas ohjataan takaisin return_url-osoitteeseesi.

Vaihe 4: Tarkista tilauksen tila

Asiakkaan palattua 3D Securesta, pollaa tilausta tarkistaaksesi lopullisen tilan.

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

Tilauksen status siirtyy johonkin seuraavista:

Tila	Merkitys
`completed`	Maksu onnistui
`cancelled`	Asiakas peruutti tai todennus epäonnistui
`error`	Käsittelyn aikana tapahtui virhe
`expired`	Tilaus vanheni ennen valmistumista

Manuaalista valtuutusta ja veloitusta korttimaksuilla varten katso Valtuutus / Veloitus / Mitätöinti -opas.

On this page