Hurtigstart

Denne guiden viser deg hvordan du oppretter og gjennomfører en testbetaling med Cost+ API-et. Når du er ferdig, har du en fungerende integrasjon du kan bygge videre på.

Forutsetninger

• En Cost+-konto med et sandbox-nettsted — opprett et i forhandlerportalen
• Din sandbox API-nøkkel (finnes under Nettsteder → ditt sandbox-nettsted → Integrasjon)

Steg 1: Opprett en ordre

Send en POST-forespørsel for å opprette en betalingsordre. Erstatt YOUR_API_KEY med din sandbox API-nøkkel:

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-et returnerer det fullstendige ordreobjektet. De viktigste feltene er id, status og payment_url i transaksjonen:

{
  "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"
    }
  ]
}

Lagre id — du trenger den i steg 3.

Steg 2: Gjennomfør testbetalingen

1. Åpne payment_url fra svaret i nettleseren din
2. På betalingssiden, skriv inn testkortdetaljene:

3. Send betalingen
4. Du blir videresendt til din return_url

Steg 3: Verifiser betalingen

Hent ordren for å bekrefte at den er gjennomført:

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

En vellykket betaling ser slik ut:

{
  "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"
      }
    }
  ]
}

Ordrens status er "completed" — betalingen var vellykket.

Steg 4: Håndter webhooken (anbefalt)

Når betalingsstatusen endres, sender Cost+ en POST-forespørsel til din webhook_url:

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

Når du mottar denne:

1. Kall GET /v1/orders/{order_id}/ for å verifisere gjeldende status (stol aldri på webhook-innholdet alene)
2. Returner HTTP 200 for å bekrefte mottak
3. Fullfør ordren hvis statusen er "completed"

Se Webhooks-guiden for logikk for nye forsøk, beste praksis og detaljer om innhold.

Alternativ: Betalingslenker

Hvis du ikke trenger serverside-videresendingslogikk, tilbyr betalingslenker en enklere vei. Opprett en lenke, del URL-en med kunden din, og sjekk statusen senere.

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

Svaret inkluderer en payment_url du kan dele via e-post, SMS eller chat. Kunden kan forsøke betaling flere ganger (opptil 25) til lenken utløper eller betalingen lykkes.

Se Betalingslenker-guiden for den fullstendige arbeidsflyten.

Hva nå?

Du har gjennomført din første betaling. Her er hva du kan gjøre videre:

• Hostet betalingsside — fullstendig HPP-referanse med alle forespørselsfelt og alternativer
• Gjentakende betalinger — sett opp abonnementer og planlagt fakturering
• Ettklikksbetaling — rask utsjekking for returnerende kunder
• Autorisering / innløsning / annullering — autoriser først, innløs senere (f.eks. ved forsendelse)
• Refusjoner — behandle fulle og delvise refusjoner
• SDK-er — offisielle biblioteker for Node.js, Python, PHP, Java/Kotlin, C#/.NET og Ruby
• Tillegg — ferdigbygde integrasjoner for Shopify, WooCommerce, Magento og mer

Relaterte endepunkter

• Opprett ordre — fullstendig API-referanse for ordreoppretting
• Hent ordre — hent ordredetaljer og status
• Opprett betalingslenke — opprett gjenbrukbare betalingslenker