Skip to main content
POST
/
gateway
/
post-account
Post to Account
curl --request POST \
  --url https://{tenant}.fincode.software/api/v6/services/gateway/post-account \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Token: <x-auth-token>' \
  --header 'platform: <platform>' \
  --header 'uuid: <uuid>' \
  --data '
[
  {
    "primaryAccountNumber": "<string>",
    "currencyCode": "<string>",
    "creditDebitInstructionDirection": "<string>",
    "instructionIdempotencykey": "<string>"
  }
]
'
Processes a double-entry accounting transaction by debiting one account and crediting one or more counterparty accounts. This is the core transaction posting mechanism for the ledger engine.

​
Request Headers

​
X-Auth-Token
string
required
The JWT Access Token obtained from the /login or /refresh-token endpoint.
​
x-fapi-auth-date
string
required
The date and time at which the request was initiated (ISO 8601 format).
​
x-fapi-customer-ip-address
string
required
The IP address of the customer making the request.
​
x-fapi-interaction-id
string
required
Unique identifier for the interaction/session.
​
Content-Type
string
default:"application/json"
required
Must be application/json.

​
Request Body

The request body is an array of account posting instructions. Each instruction represents a transaction.
​
accountPostings
array
required
Array of account posting instructions.

​
Code Examples

curl --location --request POST 'https://{domain}.fincode.software/api/v6/services/gateway/post-account' \
--header 'X-Auth-Token: YOUR_JWT_ACCESS_TOKEN' \
--header 'x-fapi-auth-date: 2024-01-15T10:30:00Z' \
--header 'x-fapi-customer-ip-address: 192.168.1.1' \
--header 'x-fapi-interaction-id: interaction-12345' \
--header 'Content-Type: application/json' \
--data '[
    {
        "primaryAccountNumber": "1234567890",
        "currencyCode": "NGN",
        "creditDebitInstructionDirection": "DEBIT_PRIMARY_ACCOUNT_CREDIT_COUNTERPARTY_ACCOUNT",
        "counterParties": [
            {
                "accountNumber": "0987654321",
                "currencyCode": "NGN",
                "amount": 5000.00,
                "narration": "Payment for services"
            }
        ],
        "instructionIdempotencykey": "unique-key-12345"
    }
]'

Headers

​
platform
string
default:fincode
required
​
uuid
string
default:200
required
​
X-Auth-Token
string
required

Body

application/json
​
primaryAccountNumber
string
​
currencyCode
string
​
creditDebitInstructionDirection
string
​
instructionIdempotencykey
string

Response

200

Transaction result