Split Payment Request

Create a split payment between two merchants. The total payment amount is charged to the customer, and the specified split_amount is allocated to the second merchant.

POST

***

Request Parameters

Name	Type	Description
`public_key`Required	`String`	Merchant identifier. Example: `i000000001`
`amount`Required	`Number`	Payment amount. Example: `100`, `20.50`
`split_user`Required	`String`	Second merchant identifier in Epoint system.
`split_amount`Required	`Number`	Payment amount for the second merchant. Example: `100`, `20.50`
`currency`Required	`String`	Payment currency. Values: `AZN`
`language`Required	`String`	Page display language. Values: `az`, `en`, `ru`
`order_id`Required	`String`	Unique order ID in your application. Max 255 characters.
`description`Optional	`String`	Payment description. Max 1000 characters.
`success_redirect_url`Optional	`String`	Redirect URL on successful payment.
`error_redirect_url`Optional	`String`	Redirect URL on failed payment.
`other_attr`Optional	`Array`	Additional 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",
  "description": "Split payment example"
}

1DATA=$(echo -n '{"public_key":"i000000001","amount":"100","split_user":"i000000002","split_amount":"30","currency":"AZN","language":"az","order_id":"order-123","description":"Split payment example"}' | 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

Name	Type	Description
`status`Required	`String`	Operation result: `success` or `error`
`redirect_url`Optional	`String`	URL to redirect the customer to the bank payment page. Present on success.
`transaction`Optional	`String`	Epoint transaction identifier. Present on success.
`message`Optional	`String`	Error description. Present on failure.
`trace_id`Required	`String`	Unique request identifier for debugging. Provide this to Epoint support for issue investigation.

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 payment list.