Pre-checkout

Fetch active payment and identification methods

Merchant can display available payment methods. For each payment method available identification methods are provided.

Operation enables merchant to:
  • Present available payment methods prior to displaying available identification methods
  • Present available identification methods prior to displaying available payment methods

Example request

To fetch payment and identification methods, send paramters, locale, nationality, currency, amount and inPerson via a server-side call to our REST API. You’ll find the complete REST API reference here

GET /v1/paymentmethods?locale=sv-SE&nationality=SE&currency=
SEK&amount=3000000&inPerson=false

x-api-key: njdfdsdkjfl5598503mnfkfe
x-merchant-key: 86969769
Content-Type: application/json

All request parameters have to submittet in the url. No message body should be sent in.

Handle the response

You can either get OK response, or an error.

Below you have an example of the response from request obove.

Status: 200 OK

{
  "paymentMethods": [
    {
      "name": "INVOICE",
      "description": "Betalning med faktura",
      "subMethods": [
        "INVOICE_SE_1"
      ],
      "identificationMethods": [
        "SE_BANKID",
        "ZIP_CODE",
        "SE_BANKID_MOBILE"
      ]
    },
    {
      "name": "PARTPAYMENT",
      "description": "Kontobetalning",
      "subMethods": [
        "PARTPAYMENT_SE_1"
      ],
      "identificationMethods": [
        "SE_BANKID",
        "ZIP_CODE",
        "SE_BANKID_MOBILE"
      ]
    }
  ],
  "localizedInfo": []
}

Get available payment method terms

Get available payment method terms for the merchant from Ecster.

Operation enables merchant to:
  • Present available payment terms on your site
  • Present available part payment options on your site
  • Present available part payment options on a specific product
 

Example request

To fetch available payment method terms, send paramters, locale, nationality, paymentMethod, currency and amount via a server-side call to our REST API. You’ll find the complete REST API reference here.

GET /v1/paymentmethods/terms?locale=sv-SE&nationality=SE&paymentMethod=PARTPAYMENT&amount=3000000&
currency=SEK

x-api-key: njdfdsdkjfl5598503mnfkfe
x-merchant-key: 86969769
Content-Type: application/json

All request parameters have to submittet in the url. No message body should be sent in.

Handle the response

You can either get OK response, or an error.

Below you have an example of the response from request obove. This is a response which includes Ecsters localized terms. You can see all valid values for parmeter id in object localizedTerms here.

Status: 200 OK

{
  "method": "PARTPAYMENT",
  "submethod": "PARTPAYMENT_SE_1",
  "nationality": "SE",
  "properties": {
    "termId": "1",
    "type": 3,
    "name": "MultiCard MasterCard",
    "interestRate": 0,
    "currency": "SEK",
    "adminFee": 1500,
    "startFee": 0,
    "minAmount": 0,
    "maxAmount": 100000000,
    "payments": 1,
    "perMonth": 3001500,
    "description": ".",
    "effectiveRate": 60,
    "creditCost": 1500,
    "minBilling": 15000,
    "termProductType": "MCARD001",
    "termsPdfUrl": "https://url/rest/public/v1/content/consumer/documents/se/sv/terms/pdf/",
    "secciPdfUrl": "https://url/rest/documents/se/sv/secci/pdf/MCARD001?amount=3000000",
    "totalAmount": 3001500,
    "creditLimit": 3200000
  },
  "localizedTerms": [
    {
      "id": "startFee",
      "text": "uppläggningsavgift",
      "value": "0",
      "unit": "kr"
    },
    {
      "id": "adminFee",
      "text": "administrativ avgift",
      "value": "15",
      "unit": "kr"
    },
    {
      "id": "interestRate",
      "text": "ränta",
      "value": "0",
      "unit": "%"
    },
    {
      "id": "payments",
      "text": "antal betalningar",
      "value": "1"
    },
    {
      "id": "perMonth",
      "text": "betalning per månad",
      "value": "30 015",
      "unit": "kr"
    },
    {
      "id": "effectiveRate",
      "text": "effektivränta",
      "value": "0,6",
      "unit": "%"
    },
    {
      "id": "creditCost",
      "text": "kreditkostnad",
      "value": "15",
      "unit": "kr"
    },
    {
      "id": "totalAmount",
      "text": "totalt att betala",
      "value": "30 015",
      "unit": "kr"
    }
  ]
}
Request test account