Mitinātā maksājuma lapa (HPP)

Mitinātā maksājuma lapa (HPP) ir Cost+ PCI DSS sertificēta maksājuma forma. Tā ļauj jums pieņemt maksājumus, neapstrādājot sensitīvus kartes datus jūsu serveros. Jūs izveidojat pasūtījumu caur API, novirzāt klientu uz mitināto lapu, un viņš atgriežas jūsu vietnē pēc maksājuma.

Kā tas darbojas

Jūsu serveris izveido pasūtījumu, izsaucot POST /v1/orders/.
API atgriež URL, kas norāda uz mitināto maksājuma lapu.
Jūs novirzāt klientu uz maksājuma lapu.
Klients pabeidz maksājumu Cost+ mitinātajā lapā.
Klients tiek novirzīts atpakaļ uz jūsu return_url (vai failure_url neveiksmīgu maksājumu gadījumā).
Cost+ nosūta webhook paziņojumu uz jūsu webhook_url ar pasūtījuma statusu.

Mitinātā maksājuma lapa ir pilnībā PCI DSS sertificēta. Jums nekad nav jāapstrādā neapstrādāti karšu numuri vai sensitīvi maksājumu dati jūsu serveros.

Pasūtījuma izveide

Ir divas pieejas HPP izmantošanai:

1. pieeja: Parādīt visas maksājumu metodes (vienkāršākā)

Izveidojiet pasūtījumu bez transactions norādīšanas. Atbilde ietver order_url — klients tiek novirzīts uz turieni un redz visas jūsu kontam aktivizētās maksājumu metodes:

Request

{
  "currency": "EUR",
  "amount": 1295,
  "merchant_order_id": "my-order-id-1",
  "description": "My amazing order",
  "return_url": "https://www.example.com",
  "webhook_url": "https://www.example.com/webhook"
}

Response

{
  "id": "43114fde-da30-4115-8004-b7f808f9b25c",
  "status": "new",
  "currency": "EUR",
  "amount": 1295,
  "order_url": "https://pay.costplus.online/43114fde.../select-payment-method/",
  "return_url": "https://www.example.com",
  "webhook_url": "https://www.example.com/webhook"
}

Novirziet klientu uz order_url. Mitinātajā lapā tiek parādītas visas aktivizētās maksājumu metodes.

2. pieeja: Iepriekš atlasīt maksājumu metodes

Izveidojiet pasūtījumu ar transactions masīvu, lai kontrolētu, kuras maksājumu metodes parādās un kādā secībā. Katrs darījums ietver payment_method, un atbilde atgriež payment_url darījuma objektā:

Request

{
  "currency": "EUR",
  "amount": 1295,
  "merchant_order_id": "my-order-id-1",
  "description": "My amazing order",
  "return_url": "https://www.example.com",
  "webhook_url": "https://www.example.com/webhook",
  "transactions": [
    { "payment_method": "credit-card" }
  ]
}

Response

{
  "id": "4851e31c-4137-4e91-95ef-1df945ee76a2",
  "status": "new",
  "currency": "EUR",
  "amount": 1295,
  "transactions": [
    {
      "id": "d291f03f-a406-428a-967a-4895a46e03fd",
      "payment_method": "credit-card",
      "status": "new",
      "payment_url": "https://pay.costplus.online/4851e31c.../credit-card/d291f03f.../"
    }
  ]
}

Novirziet klientu uz payment_url no darījuma.

Ja norādāt tikai vienu ierakstu transactions masīvā, klients tiek tieši novirzīts uz šo maksājumu metodi, neredzot atlases ekrānu. flags masīvs satur "is-test", kad tiek izmantota sandbox API atslēga.

Pieprasījuma lauki

Lauks	Obligāts	Apraksts
`currency`	Jā	ISO 4217 valūtas kods (piemēram, `EUR`, `GBP`, `SEK`)
`amount`	Jā	Summa centos. Piemēram, 12,95 EUR tiek attēlots kā `1295`
`merchant_order_id`	Nē	Jūsu pašu atsauces ID pasūtījumam
`return_url`	Nē	URL, uz kuru novirzīt klientu pēc maksājuma (noklusējums visiem statusiem)
`failure_url`	Nē	URL, uz kuru novirzīt klientu ar `cancelled`, `expired` vai `error` statusu (skatiet atgriešanas URL zemāk)
`locale`	Nē	Maksājuma lapas valoda. Atbalstītās: `en-GB`, `de-DE`, `nl-NL`, `nl-BE`, `fr-BE`, `sv-SE`, `no-NO`, `da-DK`
`description`	Nē	Pasūtījuma apraksts, kas tiek parādīts klientam
`payment_methods`	Nē	Filter to a single payment method (e.g. `["credit-card"]`). Omit to show all enabled methods. For multiple specific methods, use the `transactions` array instead
`webhook_url`	Nē	URL statusa izmaiņu paziņojumu saņemšanai
`expiration_period`	Nē	ISO 8601 ilgums pasūtījuma termiņam. Noklusējums ir `PT30M` (30 minūtes)

amount lauks vienmēr ir mazākajā valūtas vienībā (centos). Norādot 1295, tas nozīmē 12,95 dotajā valūtā. Norādot 1295.00 vai 12.95, radīsies kļūda vai nepareiza maksa.

Vairākas maksājumu metodes

Lai piedāvātu vairākas konkrētas maksājumu metodes, pievienojiet vairākus ierakstus transactions masīvam. Secība mitinātajā lapā atbilst masīva secībai:

"transactions": [
  { "payment_method": "credit-card" },
  { "payment_method": "apple-pay" }
]

The payment_methods field on orders accepts at most one value. To offer multiple specific methods, always use the transactions array. If you need a reusable link with multiple payment methods, consider Payment Links instead, which support a true payment_methods array.

Atgriešanas URL

Pēc maksājuma klients tiek novirzīts, pamatojoties uz pasūtījuma statusu un norādītajiem URL:

Kad ir iestatīti gan return_url, gan failure_url:
- cancelled, expired vai error → klients tiek novirzīts uz failure_url
- Visi pārējie statusi → klients tiek novirzīts uz return_url
Kad ir iestatīts tikai return_url:
- Visi statusi → klients tiek novirzīts uz return_url

Izmantojiet failure_url, lai parādītu atkārtotas mēģināšanas vai atbalsta lapu neveiksmīgiem maksājumiem, kamēr return_url parāda pasūtījuma apstiprinājumu. Ja jums nepieciešams tikai viens galamērķis, pietiek ar return_url vien.

Atcelšanas pogas uzvedība

Mitinātajā maksājuma lapā ir atcelšanas poga. Kad klients uz tās noklikšķina, viņš tiek novirzīts uz failure_url (ja norādīts) vai return_url. Pasūtījuma statuss pāries uz cancelled. Vienmēr verificējiet pasūtījuma statusu caur API vai webhook, nevis paļaujieties tikai uz novirzīšanu.

Saistītie galapunkti

Izveidot pasūtījumu — izveidot maksājuma pasūtījumu un saņemt payment_url
Iegūt pasūtījumu — pārbaudīt pasūtījuma statusu pēc maksājuma

On this page