Kort (Visa og Mastercard)

Yfirlit

Taktu á móti greiðslum með kredit- og debetkortum gegnum Cost+ API með greiðslumátanum credit-card.

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

Studd kortamerki

Kortamerki	Tegund
Amex	Kredit
Mastercard	Kredit / Debet
Maestro	Debet
Visa	Kredit / Debet
V Pay	Debet

Stillingarvalkostir

Kvikur lýsir

Notaðu dynamic_descriptor reitinn til að stilla sérsniðinn texta sem birtist á banka- eða kortayfirliti viðskiptavinar.

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

Notkun nafns viðskiptavinar sem nafn korthafa

Stilltu use_customer_name_as_cardholder_name á true til að nota sjálfkrafa nafn viðskiptavinar úr pöntuninni sem nafn korthafa.

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

Sérsniðið kortainnsláttar form

Ef þú vilt smíða þitt eigið kortainnsláttar form í stað þess að nota hýstu greiðslusíðuna, fylgdu þessum fjórum skrefum.

Skref 1: Stofnaðu pöntun með uppsetningartákni

Stofnaðu pöntun og taktu með setup_token: true í payment_method_details transakcije. Þetta segir Cost+ að búa til uppsetningartákn sem þú getur notað til að tákna kortagögn á öruggan hátt.

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

Svarið mun innihalda gildi setup_token í payment_method_details transakcije:

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

Skref 2: Táknaðu kortagögn

Sendu PAN kortsins, gildistíma og uppsetningartáknið á táknendapunktinn. Þetta vistar kortið á öruggan hátt og skilar 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..."
  }'

Svar:

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

Skref 3: Auðkenndu færsluna

Sendu vault_token og cvc á auðkenningarendapunktinn. Ef 3D Secure auðkenning er nauðsynleg færðu redirect_url til að endurbeina viðskiptavininum á auðkenningarsíðu bankans.

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

Svar:

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

Endurbeindu viðskiptavininum á redirect_url til að ljúka 3D Secure auðkenningu. Eftir að viðskiptavinurinn lýkur (eða hættir við) auðkenningu verður honum vísað aftur á return_url þitt.

Skref 4: Kannaðu stöðu pöntunar

Eftir að viðskiptavinurinn snýr aftur frá 3D Secure, kannaðu pöntunina til að athuga lokastöðuna.

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

Staða pöntunar mun breytast í eina af:

Staða	Merking
`completed`	Greiðsla tókst
`cancelled`	Viðskiptavinur hætti við eða auðkenning mistókst
`error`	Villa kom upp við vinnslu
`expired`	Pöntun rann út áður en henni var lokið

Fyrir handvirk heimildar- og söfnunarflæði með kortagreiðslum, sjá leiðbeininguna Heimild / söfnun / ógilding.

On this page