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.
orderFrom string Optional. Must be "DAMP" if present.
fpgoUuid string Optional. Must exist in App\Models\Order.
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