Create Transaction

Initiate a new remittance transaction using existing customer profiles.

POST /transactionmanagement/create-transaction

Create Transaction

cURL

curl --request POST \
  --url https://{tenant}.fincode.software/api/v6/services/transactionmanagement/create-transaction \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Token: <x-auth-token>' \
  --header 'X-Idempotency-Key: <x-idempotency-key>' \
  --header 'ipAddress: <ipaddress>' \
  --header 'password: <password>' \
  --header 'platform: <platform>' \
  --header 'uuid: <uuid>' \
  --data '
{
  "amount": "<string>",
  "sendAmount": "<string>",
  "inclussive": true,
  "receivingCurrency": "NGN",
  "sendCurrency": "GBP",
  "type": "ACCOUNTPAYMENT",
  "preExistingSenderCustomerCode": "<string>",
  "preExistingRecipientCustomerCode": "<string>",
  "creditParty": [
    {}
  ],
  "internationalTransferInformation": {},
  "transactionProcessingMode": "NONE_AGGREGATION",
  "descriptionText": "<string>",
  "transactionModule": "REMITTANCE"
}
'

Full Customer Flow

Initiates a new transaction where the sender and recipient have already been onboarded. You must provide the preExistingSenderCustomerCode and preExistingRecipientCustomerCode.

This endpoint is used for Remittance transactions where we are managing the customer lifecycle via the User Management APIs.

Headers

platform · string · default: fincode · required

uuid · string · default: 200 · required

X-Auth-Token · string · required

password · string · required

ipAddress · string · required

X-Idempotency-Key · string · required

Body

application/json

amount · string · required

sendAmount · string · required

inclussive · boolean · required

receivingCurrency · string · default: NGN · required

sendCurrency · string · default: GBP · required

type · string · default: ACCOUNTPAYMENT · required

preExistingSenderCustomerCode · string · required

preExistingRecipientCustomerCode · string · required

creditParty · object[] · required

internationalTransferInformation · object · required

transactionProcessingMode · string · default: NONE_AGGREGATION

descriptionText · string

transactionModule · string · default: REMITTANCE

Response

200

Transaction created