Internal Payments
Path parameters
customerIdstringRequired
Header parameters
authorizationstringOptional
Authorization header containing your API Token
x-alg-noncestringOptional
Nonce used to generate the payload signature
x-alg-signaturestringOptional
Payload signature
datestringOptional
Date of the request un UTC/GMT
Body
sourceAccountIdstring · uuidRequired
destinationAccountIdstring · uuidRequired
idempotencyKeystring · uuidRequired
amountnumberRequiredExample:
Amount in hundreds, ie. for £1.2 enter 120
129
externalReferencestring · uuidRequired
Reference of the payment
descriptionstring | nullableRequiredExample:
Description of the payment
Sent from Algbra
Responses
200
Returns payment id to be used in the next step
application/json
400
Input validation error
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
412
Modulus / IBAN error
application/json
post
POST /v1/partner/payments/customers/{customerId}/payments/internal HTTP/1.1
Host: api-url
Content-Type: application/json
Accept: */*
Content-Length: 281
{
"sourceAccountId": "123e4567-e89b-12d3-a456-426614174000",
"destinationAccountId": "123e4567-e89b-12d3-a456-426614174000",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"amount": 129,
"externalReference": "123e4567-e89b-12d3-a456-426614174000",
"description": "Sent from Algbra"
}
{
"paymentId": "123e4567-e89b-12d3-a456-426614174000",
"processingState": "CREATED",
"createdOn": "2025-07-01T03:07:58.783Z",
"transaction": {
"transactionId": "text",
"uniqueToken": "123e4567-e89b-12d3-a456-426614174000",
"origin": "TRANSFER",
"state": "PENDING",
"category": "GENERAL",
"impactType": "NEUTRAL",
"customerId": "123e4567-e89b-12d3-a456-426614174000",
"amount": 129,
"currencyCode": "AFN",
"description": "text",
"exchangeRate": "text",
"exchangeCurrencyCode": "AFN",
"sourceCounterparty": {
"type": "PERSONAL",
"details": {
"firstName": "John",
"lastName": "Doe"
},
"accountCurrency": "GBP",
"accountReferenceType": "UK_ACCOUNT",
"accountReference": {
"type": "UK_ACCOUNT",
"sortCode": "010102",
"accountNumber": "12345678"
}
},
"destinationCounterparty": {
"type": "PERSONAL",
"details": {
"firstName": "John",
"lastName": "Doe"
},
"accountCurrency": "GBP",
"accountReferenceType": "UK_ACCOUNT",
"accountReference": {
"type": "UK_ACCOUNT",
"sortCode": "010102",
"accountNumber": "12345678"
}
},
"transactionDate": "2025-07-01T03:07:58.783Z"
},
"initiationRequest": {
"sourceAccountId": "123e4567-e89b-12d3-a456-426614174000",
"destinationAccountId": "123e4567-e89b-12d3-a456-426614174000",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"amount": 129,
"externalReference": "123e4567-e89b-12d3-a456-426614174000",
"description": "Sent from Algbra"
}
}
Last updated
Was this helpful?