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