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.*.name` string Required. Product name.
products.*.productId` string Optional. Unique identifier (max: 25 chars).
products.*.quantity` numeric Required. Quantity of product.
products.*.rate` numeric Required. Unit rate/price.
products.*.discount` numeric Optional. Discount applied.
products.*.tax` numeric Required. Tax applied.
products.*.amount` numeric Required. Total amount after calculation.
orderSummary.subTotal` numeric Required. Subtotal of all items.
orderSummary.totalTax` numeric Required. Total tax.
orderSummary.totalDiscount` numeric Required. Total discount.
orderSummary.grandTotal` numeric Required. Grand total.
orderDate` string Required. Order date (timestamp).
referenceNo` string Optional. Reference number.
customerReference` string Optional. Customer reference.
invoiceInterval` numeric Optional. Invoice interval (allowed: 0,1,2).
separateInvoices` boolean Optional. Whether invoices should be separated.
invoiceFeeApplicable` boolean Required. Whether invoice fee applies.
invoiceMaturity` numeric Optional. Invoice maturity period.
callback.callbackUrl` url Optional. General callback URL.
callback.success` string Required. Success callback URL.
callback.failure` string Required. Failure callback URL.
settings.secureDetails` boolean Optional. Enable secure details.
customerDetails.type` string Required. Customer type (`private`/`corporate`).
customerDetails.countryCode` string Required. Customer country code.
customerDetails.msisdn` string Required. Customer mobile number.
customerDetails.email` email Required. Customer email address.
customerDetails.name` string Required. Customer full name.
customerDetails.personalNumber` string Optional. Required if `submitPayment.via=invoice`. Must be 11 digits.
customerDetails.preferredLanguage` string Optional. Preferred language.
customerDetails.organizationId` string Required if corporate. Must be alphanumeric.
customerDetails.address.street` string Required. Street address.
customerDetails.address.zip` string Required. ZIP code.
customerDetails.address.city` string Required. City.
customerDetails.address.country` 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