Virtual Account Services
  1. Group Codes
Virtual Account Services
  • Introduction
  • Terminologies
  • Webhooks
  • Authentication
  • Account
    • Create Account
      POST
    • Rename Account
      POST
    • Balance Inquiry
      GET
    • Create Bulk Accounts
      POST
    • List Accounts
      GET
  • Transaction
    • Credit Account
      POST
    • Debit Account
      POST
    • Credit Account [Agency Banking]
      POST
    • Debit Account [Agency Banking]
      POST
    • Transaction Query
      GET
    • Transaction Details
      GET
    • Transaction History
      GET
  • Transfer
    • Get Institutions
      GET
    • Name Inquiry
      POST
    • Interbank Transfer
      POST
    • Interbank Transfer [Sync]
      POST
    • Transfer Query
      GET
    • Transfer Enquiry
      GET
    • Virtual Account Intrabank Transfer
      POST
    • Core Banking Intrabank Transfer
      POST
    • Collection Accounts Intrabank Transfer
      POST
  • Invoice
    • Create Invoice
    • Get Invoice Detail
    • List Merchant Invoices
  • Refunds
    • Initiate Refund
    • Get Refund Status
    • Get Refunds
  • Notifications
    • Notification
    • Send Notification
  • Merchant
    • Account
      • Get Account
      • Activate Sub Ledger For Merchant
      • Get SubLedger Callback Urls
      • Set SubLedger Callback Urls
      • Get Collection Accounts
    • Transfer
      • Get Transfer History
      • Get Subledger transfers
      • Get Transfer Details
      • Name Inquiry
    • Refund
      • Refund Details
  • Admin
    • Accounting
      • Get GL Accounts
      • Get Classification Codes
    • Dashboard
      • Dashboard Summary
      • Dashboard Transactions
      • Dashboard Transaction Details
    • Group Codes
      • Get Group Codes
        GET
      • Set Collection Account
        POST
      • Create Group Code
        POST
    • Reporting
      • Get Report Types
      • Get Report Parameters
      • Create Report
      • Get Reports
      • Get Reports Details
  1. Group Codes

Create Group Code

POST
/admin/groupcodes
This API enables you to create a new group code for a client, which is essential for organizing and managing client accounts under a specific group. This functionality is vital for structuring client data and streamlining subsequent transactions and reporting.

Request Body#

The request body is a JSON object with the following fields:
Field NameData TypeRequiredDescription
clientIdintegertrueUnique identifier for the client.
typestringtrueThe type of the group code (e.g., "Normal").
descriptionstringtrueA brief description of the group code.
productIdintegertrueUnique identifier for the associated product.
customerNubanbooleantrueIndicates whether a custom NUBAN should be enforced.

Response Body#

The response is a JSON object containing the details of the created group code.
Field NameData TypeDescription
clientIdintegerUnique identifier for the client.
typestringThe type of the group code (e.g., "Normal").
descriptionstringA brief description of the group code.
productIdintegerUnique identifier for the associated product.
customerNubanbooleanIndicates whether a custom NUBAN was enforced.

Request

Body Params application/json

Example
{
    "clientId":2,
    "type": "Normal",
    "description": "Jumia Pay App",
    "productId": 101,
    "customerNuban": false
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/admin/groupcodes' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clientId":2,
    "type": "Normal",
    "description": "Jumia Pay App",
    "productId": 101,
    "customerNuban": false
}'

Responses

🟢200Create Group Code
application/json
Body

Example
{
    "clientId": 2,
    "productId": 101,
    "type": "Normal",
    "groupCode": "24JRD25EPC",
    "description": "Jumia Pay App",
    "enforceExternalId": false
}
Modified at 2025-03-15 08:25:34
Previous
Set Collection Account
Next
Get Report Types
Built with