Create finance request

​
Body
required
application/json
  • amount
    Type: integer
    greater than:  
    0
    min:  
    -9007199254740991
    max:  
    9007199254740991
    required

    Amount in cents

  • currency
    enum
    required

    Currency

    values
    • CAD
    • USD
  • customerId
    Type: stringFormat: uuid
    required

    Customer UUID

  • type
    enum
    required

    Type of financing agreement requested

    values
    • fixed_mca
    • fixed_fepa
    • ewa
  • externalId
    Type: string

    Partner-defined reference

  • metadata
    Type: object

    Partner-defined metadata

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/finance-requests
curl https://api-sandbox.tryslatehq.com/finance-requests \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_SECRET_TOKEN' \
  --data '{
  "customerId": "123e4567-e89b-12d3-a456-426614174000",
  "amount": 10000,
  "currency": "CAD",
  "type": "fixed_fepa",
  "externalId": "fr_123",
  "metadata": {
    "shiftDate": "2026-04-01",
    "rate": "67",
    "hours": "3.4"
  }
}'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "customerId": "123e4567-e89b-12d3-a456-426614174000",
  "externalId": "fr_123",
  "status": "CREATED",
  "type": "fixed_fepa",
  "amount": 10000,
  "currency": "CAD",
  "metadata": {
    "shiftDate": "2026-04-01",
    "rate": "67",
    "hours": "3.4"
  },
  "financingAgreementId": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2026-05-26T22:23:03.881Z",
  "updatedAt": "2026-05-26T22:23:03.881Z",
  "expiresAt": "2026-05-26T22:23:03.881Z"
}

OK