Cost+Docs

Karti (Visa u Mastercard)

Aċċetta ħlasijiet bil-karti ta' kreditu u debitu

Ħarsa Ġenerali

Aċċetta ħlasijiet bil-karti ta' kreditu u debitu permezz tal-API ta' Cost+ bl-użu tal-metodu ta' ħlas credit-card.

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

Marki ta' Karti Appoġġjati

MarkaTip
AmexKreditu
MastercardKreditu / Debitu
MaestroDebitu
VisaKreditu / Debitu
V PayDebitu

Opzjonijiet ta' Konfigurazzjoni

Deskrittur Dinamiku

Uża l-qasam dynamic_descriptor biex tissettja test ta' stqarrija personalizzat li jidher fuq l-istqarrija tal-bank jew tal-karta tal-klijent tiegħek.

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

Uża l-Isem tal-Klijent bħala Isem id-Detentur tal-Karta

Issettja use_customer_name_as_cardholder_name għal true biex awtomatikament tuża l-isem tal-klijent mill-ordni bħala l-isem tad-detentur tal-karta.

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

Formola Personalizzata tad-Dħul tal-Karta

Jekk trid tibni l-formola tad-dħul tal-karta tiegħek stess minflok tuża l-paġna ta' ħlas ospitata, segwi dawn l-erba' passi.

Pass 1: Oħloq Ordni b'Setup Token

Oħloq ordni u inkludi setup_token: true fid-payment_method_details tat-tranżazzjoni. Dan jgħid lil-Cost+ biex tiġġenera setup token li tista' tuża biex b'mod sigur tittokenizza d-dettalji tal-karta.

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

Ir-risposta se tinkludi valur ta' setup_token fid-payment_method_details tat-tranżazzjoni:

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

Pass 2: Ittokenizza d-Dettalji tal-Karta

Ibgħat il-PAN tal-karta, id-data ta' skadenza, u s-setup token lejn l-endpoint tat-token. Dan jivvawltja l-karta b'mod sigur u jirritorna 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..."
  }'

Risposta:

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

Pass 3: Awtentika t-Tranżazzjoni

Issottometti l-vault_token u cvc lejn l-endpoint tal-awtentikazzjoni. Jekk 3D Secure huwa meħtieġ, tirċievi redirect_url biex tirridirezzjona l-klijent lejn il-paġna ta' awtentikazzjoni tal-bank tagħhom.

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

Risposta:

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

Irridirezzjona l-klijent lejn redirect_url biex jlesti l-awtentikazzjoni 3D Secure. Wara li l-klijent jlesti (jew jikkanċella) l-awtentikazzjoni, jiġi ridirezzjonat lura lejn ir-return_url tiegħek.

Pass 4: Agħmel Polling tal-Istatus tal-Ordni

Wara li l-klijent jirritorna minn 3D Secure, agħmel polling tal-ordni biex tiċċekkja l-istatus finali.

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

L-istatus tal-ordni tinbidel għal waħda minn:

StatusTifsira
completedIl-ħlas irnexxielu
cancelledIl-klijent ikkanċella jew l-awtentikazzjoni falliet
errorŻball seħħ waqt l-ipproċessar
expiredL-ordni skadiet qabel ma tlestiiet

Għal flussi ta' awtorizzazzjoni manwali u capture b'ħlasijiet tal-karti, ara l-gwida Auth / Capture / Void.

On this page