Skip to Content
docs
Split PaymentSplit Payment Request

Split Payment Request

Create a split payment between two merchants. The customer pays the total amount, and it is automatically distributed between the primary and secondary merchants.

POST
***

Request Parameters

NameTypeDescription
public_keyRequired
StringPrimary merchant identifier. Example: `i000000001`
amountRequired
NumberTotal payment amount. Example: `100`, `20.50`
split_userRequired
StringSecond merchant identifier in Epoint system.
split_amountRequired
NumberAmount for the second merchant. Example: `100`, `20.50`
currencyRequired
StringPayment currency. Values: `AZN`
languageRequired
StringPage display language. Values: `az`, `en`, `ru`
order_idRequired
StringUnique order ID. Max 255 characters.
descriptionOptional
StringPayment description. Max 1000 characters.
success_redirect_urlOptional
StringRedirect URL on success.
error_redirect_urlOptional
StringRedirect URL on failure.
other_attrOptional
ArrayAdditional parameters.

Request Example

Send Request
Payload
{
  "public_key": "i000000001",
  "amount": 100,
  "split_user": "i000000002",
  "split_amount": 30,
  "currency": "AZN",
  "language": "az",
  "order_id": "order-123"
}
1DATA=$(echo -n '{"public_key":"i000000001","amount":100,"split_user":"i000000002","split_amount":30,"currency":"AZN","language":"az","order_id":"order-123"}' | base64)
2SIGNATURE=$(echo -n "$PRIVATE_KEY$DATA$PRIVATE_KEY" | openssl dgst -sha1 -binary | base64)
3

4curl -X POST *** \
5-H "Content-Type: application/x-www-form-urlencoded" \
6-d "data=$DATA&signature=$SIGNATURE"

Response Parameters

NameTypeDescription
statusRequired
StringOperation result: `success` or `error`
redirect_urlOptional
StringURL to redirect the customer to the bank payment page. Present on success.
transactionOptional
StringEpoint transaction identifier. Present on success.
messageOptional
StringError description. Present on failure.
trace_idRequired
StringUnique request identifier for debugging. Provide this to Epoint support for issue investigation.

Success

Success Response
1{
2  "status": "success",
3  "redirect_url": "https://bank.gateway.url/...",
4  "transaction": "te_0000000001",
5  "trace_id": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
6}

Note: The second merchant’s payment amount will only appear in their own payment list.

OverviewSplit Execute Pay