Ātrais sākums

Šī pamācība palīdzēs jums izveidot un pabeigt testa maksājumu, izmantojot Cost+ API. Beigās jums būs strādājoša integrācija, uz kuras varēsiet turpināt būvēt.

Priekšnosacījumi

• Cost+ konts ar sandbox tīmekļa vietni — izveidojiet to tirgotāja portālā
• Jūsu sandbox API atslēga (atrodama sadaļā Websites → jūsu sandbox vietne → Integration)

1. solis: Izveidojiet pasūtījumu

Nosūtiet POST pieprasījumu, lai izveidotu maksājuma pasūtījumu. Aizstājiet YOUR_API_KEY ar savu sandbox API atslēgu:

curl -X POST https://api.costplus.online/v1/orders/ \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "EUR",
    "amount": 1295,
    "merchant_order_id": "my-first-order",
    "description": "Test order",
    "return_url": "https://example.com/return",
    "webhook_url": "https://example.com/webhook",
    "transactions": [
      {
        "payment_method": "credit-card"
      }
    ]
  }'

API atgriež pilnu pasūtījuma objektu. Galvenie lauki ir id, status un payment_url darījumā:

{
  "id": "4851e31c-4137-4e91-95ef-1df945ee76a2",
  "status": "new",
  "currency": "EUR",
  "amount": 1295,
  "merchant_order_id": "my-first-order",
  "description": "Test order",
  "return_url": "https://example.com/return",
  "webhook_url": "https://example.com/webhook",
  "created": "2026-01-15T12:00:05.433502+00:00",
  "modified": "2026-01-15T12:00:05.553125+00:00",
  "expiration_period": "PT1H",
  "transactions": [
    {
      "id": "d291f03f-a406-428a-967a-4895a46e03fd",
      "payment_method": "credit-card",
      "status": "new",
      "amount": 1295,
      "currency": "EUR",
      "payment_url": "https://pay.costplus.online/4851e31c.../credit-card/d291f03f...",
      "is_capturable": false,
      "expiration_period": "PT30M"
    }
  ]
}

Saglabājiet id — tas būs nepieciešams 3. solī.

2. solis: Pabeidziet testa maksājumu

1. Atveriet pārlūkprogrammā payment_url no atbildes
2. Maksājuma lapā ievadiet testa kartes datus:

3. Apstipriniet maksājumu
4. Jūs tiksiet novirzīts atpakaļ uz jūsu return_url

3. solis: Verificējiet maksājumu

Iegūstiet pasūtījumu, lai apstiprinātu tā pabeigšanu:

curl -u YOUR_API_KEY: \
  https://api.costplus.online/v1/orders/4851e31c-4137-4e91-95ef-1df945ee76a2/

Veiksmīgs maksājums izskatās šādi:

{
  "id": "4851e31c-4137-4e91-95ef-1df945ee76a2",
  "status": "completed",
  "currency": "EUR",
  "amount": 1295,
  "merchant_order_id": "my-first-order",
  "completed": "2026-01-15T12:02:30.123456+00:00",
  "transactions": [
    {
      "id": "d291f03f-a406-428a-967a-4895a46e03fd",
      "payment_method": "credit-card",
      "status": "completed",
      "amount": 1295,
      "currency": "EUR",
      "payment_method_details": {
        "truncated_pan": "1111",
        "card_expiry": "122028"
      }
    }
  ]
}

Pasūtījuma status ir "completed" — maksājums bija veiksmīgs.

4. solis: Apstrādājiet webhook (ieteicams)

Kad mainās maksājuma statuss, Cost+ nosūta POST pieprasījumu uz jūsu webhook_url:

{
  "event": "status_changed",
  "order_id": "4851e31c-4137-4e91-95ef-1df945ee76a2"
}

Kad saņemat šo:

1. Izsauciet GET /v1/orders/{order_id}/, lai verificētu pašreizējo statusu (nekad neuzticieties tikai webhook saturam)
2. Atgrieziet HTTP 200, lai apstiprinātu saņemšanu
3. Izpildiet pasūtījumu, ja statuss ir "completed"

Skatiet Webhook pamācību, lai uzzinātu par atkārtošanas loģiku, labāko praksi un datu formātiem.

Alternatīva: Maksājuma saites

Ja jums nav nepieciešama servera puses novirzīšanas loģika, maksājuma saites piedāvā vienkāršāku ceļu. Izveidojiet saiti, kopīgojiet URL ar savu klientu un pārbaudiet statusu vēlāk.

curl -X POST https://api.costplus.online/v1/paymentlinks/ \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "merchant_order_id": "invoice-1234",
    "amount": 2500,
    "currency": "EUR",
    "description": "Invoice #1234"
  }'

Atbilde ietver payment_url, ko varat kopīgot pa e-pastu, SMS vai tērzēšanā. Klients var mēģināt veikt maksājumu vairākas reizes (līdz 25), līdz saite beidzas vai maksājums ir veiksmīgs.

Skatiet Maksājuma saišu pamācību pilnam darbplūsmas aprakstam.

Kas tālāk?

Jūs esat pabeidzis savu pirmo maksājumu. Tālāk varat doties šeit:

• Mitināta maksājuma lapa — pilna HPP atsauce ar visiem pieprasījuma laukiem un opcijām
• Atkārtoti maksājumi — iestatiet abonementus un ieplānotu norēķinu
• Maksājumi ar vienu klikšķi — ātra norēķināšanās atgriežošiem klientiem
• Autorizācija / Iegūšana / Anulēšana — vispirms autorizējiet, iegūstiet vēlāk (piemēram, nosūtot preci)
• Atmaksas — apstrādājiet pilnas un daļējas atmaksas
• SDK — oficiālās bibliotēkas Node.js, Python, PHP, Java/Kotlin, C#/.NET un Ruby
• Spraudņi — gatavas integrācijas Shopify, WooCommerce, Magento un citām platformām

Saistītie galapunkti

• Izveidot pasūtījumu — pilna API atsauce pasūtījuma izveidei
• Iegūt pasūtījumu — iegūt pasūtījuma datus un statusu
• Izveidot maksājuma saiti — izveidot atkārtoti lietojamas maksājuma saites