Skip to main content

Create Session for Invoice Order

This endpoint allows you to export an order as an invoice to Front Payment Go. Upon successful submission, it returns:

  • Order UUID
  • Customer UUID
  • Bank ID Verification URL (for customer identity verification)

Request

  • Endpoint: https://demo-api.frontpayment.no/api/v1/connect/orders/invoice/submit
  • Method: POST
  • Authorization: Bearer <token>

Payload Schema

Field Type Description
products.*.namename` string Required. Product name.
products.*.productIdproductId` string Optional. Unique identifier (max: 25 chars).
products.*.quantityquantity` numeric Required. Quantity of product.
products.*.raterate` numeric Required. Unit rate/price.
products.*.discountdiscount` numeric Optional. Discount applied.
products.*.taxtax` numeric Required. Tax applied.
products.*.amountamount` numeric Required. Total amount after calculation.
orderSummary.subTotalsubTotal` numeric Required. Subtotal of all items.
orderSummary.totalTaxtotalTax` numeric Required. Total tax.
orderSummary.totalDiscounttotalDiscount` numeric Required. Total discount.
orderSummary.grandTotalgrandTotal` numeric Required. Grand total.
orderDateorderDate` string Required. Order date (timestamp).
referenceNoreferenceNo` string Optional. Reference number.
customerReferencecustomerReference` string Optional. Customer reference.
invoiceIntervalinvoiceInterval` numeric Optional. Invoice interval (allowed: 0,1,2).
separateInvoicesseparateInvoices` boolean Optional. Whether invoices should be separated.
invoiceFeeApplicableinvoiceFeeApplicable` boolean Required. Whether invoice fee applies.
invoiceMaturityinvoiceMaturity` numeric Optional. Invoice maturity period.
callback.callbackUrlcallbackUrl` url Optional. General callback URL.
callback.successsuccess` string Required. Success callback URL.
callback.failurefailure` string Required. Failure callback URL.
settings.secureDetailssecureDetails` boolean Optional. Enable secure details.
customerDetails.typetype` string Required. Customer type (private`private`/corporate`corporate`).
customerDetails.countryCodecountryCode` string Required. Customer country code.
customerDetails.msisdnmsisdn` string Required. Customer mobile number.
customerDetails.emailemail` email Required. Customer email address.
customerDetails.namename` string Required. Customer full name.
customerDetails.personalNumberpersonalNumber` string Optional. Required if `submitPayment.via=invoiceinvoice`. Must be 11 digits.
customerDetails.preferredLanguagepreferredLanguage` string Optional. Preferred language.
customerDetails.organizationIdorganizationId` string Required if corporate. Must be alphanumeric.
customerDetails.address.streetstreet` string Required. Street address.
customerDetails.address.zipzip` string Required. ZIP code.
customerDetails.address.citycity` string Required. City.
customerDetails.address.countrycountry` string Required. Country code (e.g., "NO").

Example Request

{
  "products": [
    {
      "name": "Router",
      "productId": "R_1",
      "quantity": "1",
      "rate": 40,
      "discount": 0,
      "tax": "0",
      "amount": 40
    }
  ],
  "orderSummary": {
    "subTotal": "40",
    "totalTax": "0",
    "totalDiscount": "0.00",
    "grandTotal": "40"
  },
  "orderDate": "1755150488",
  "customerDetails": {
    "type": "private",
    "countryCode": "+47",
    "msisdn": "46567468",
    "email": "[email protected]",
    "name": "Zahidul",
    "preferredLanguage": "en",
    "personalNumber": "28038712383",
    "organizationId": "",
    "address": {
      "street": "Klosterenget 144",
      "zip": "7030",
      "city": "Trondheim",
      "country": "NO"
    }
  },
  "referenceNo": "Dhaka",
  "customerReference": "3500",
  "invoiceInterval": 0,
  "separateInvoices": true,
  "invoiceFeeApplicable": true,
  "invoiceMaturity": 10,
  "callback": {
    "callbackUrl": "https://wp.frontpayment.no/?order_identifier=rRbl1FWZG59o&order_status=success",
    "success": "https://wp.frontpayment.no/?order_identifier=rRbl1FWZG59o&order_status=success",
    "failure": "https://frontpayment.no/?order_identifier=rRbl1FWZG59o&order_status=failed"
  }
}

Example Success Response

{
  "status_code": 201,
  "status_message": "OK",
  "message": "orderCreatedSuccessfully",
  "is_data": true,
  "data": {
    "orderUuid": "ODR4286244937",
    "customerUuid": "CSRT3419523642",
    "bankIdUrl": "https://auth.current.bankid.no/precheck/auth?...state=eyJvcmRlclV1aWQiOiJPRFI0Mjg2MjQ0OTM3IiwiY29ubmVjdCI6InllcyJ9"
  }
}

Other Responses

Internal Error (500)

{
  "status_code": 500,
  "status_message": "Internal Dependency Error",
  "message": "Internal Error Occurred Please Try Again Later",
  "is_error": true,
  "errors": {
    "happenedAt": "String",
    "internalErrorDetails": "Array"
  }
}

Execution Exception (510)

{
  "status_code": 510,
  "status_message": "Execution Exception Occurred",
  "message": "Something Went Wrong",
  "is_error": true,
  "errors": "Array"
}

Notifications via Callback URL

Go To Notication Via Callback Url Page

Back to top