Skip to main content
POST
/
transactionmanagement
/
create-transaction
Create Transaction
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