Skip to main content
POST
/
client
/
transactions
/
initiate
cURL
curl --request POST \
  --url https://sandbox-remote-api.rayda.co/api/v2/client/transactions/initiate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "payment_method": "Card",
  "employee_country_id": "b9bbd993-6556-4186-a00b-61346f9f66be",
  "redirect_url": "http://localhost:3000/dashboard/transactions",
  "orders": [
    {
      "asset_pricing_id": "9d5d53c1-9ff0-4140-83d8-3da1dbb603d1",
      "employee_id": "9e199aff-9ac7-47f9-8e43-91d90a5ee4df",
      "quantity": 2,
      "fulfillment_date": "2025-01-30",
      "device_setup": "ABM",
      "note": "Unpack this device"
    }
  ]
}
'
{
  "success": true,
  "message": "Record created successfully",
  "data": {
    "tx_ref": "tx_ref_r_679e6440309fa",
    "payment_method": "Card",
    "amount": 7200,
    "insurance": 360,
    "gateway_fee": 232.74,
    "onboarding_fee": 198,
    "device_config_fee": 0,
    "platform_fee": 0,
    "total_amount": 7990.74,
    "currency": "GBP",
    "link": "https://checkout.stripe.com/c/pay/...",
    "status": "Pending"
  }
}
Use this endpoint to initiate a transaction before placing an order. It calculates the total amount based on the requested assets and returns a payment link for completing the transaction.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

The transaction details, including order information and payment method.

​
payment_method
string
required

The payment method selected by the client (e.g., "Card").

Example:

"Card"

​
employee_country_id
string<uuid>
required

The ID of the employee's resident country.

Example:

"b9bbd993-6556-4186-a00b-61346f9f66be"

​
redirect_url
string<uri>
required

The URL to redirect the user after payment completion.

Example:

"http://localhost:3000/dashboard/transactions"

​
orders
object[]
required

Response

Transaction initiated successfully. Returns payment link and transaction details.

​
success
boolean
Example:

true

​
message
string
Example:

"Record created successfully"

​
data
object