Merchant Onboarding

Transacty Merchant Onboarding

This guide is for your merchants. Goal: start using Transacty in a few easy steps.

1) What You Get From Transacty

When a merchant is onboarded, they get:

  • apiKey
  • secret
  • baseUrl — https://api.transacty.ai

They use these to call Transacty APIs.

2) Main Endpoints Merchants Use

Auth / identity

  • GET /v1/me

Balance

  • GET /v1/balance

PAYIN (customer pays merchant)

  • POST /v1/payins
  • GET /v1/payins/:id

PAYOUT (merchant sends money out)

  • POST /v1/payouts
  • GET /v1/payouts/:id

Transactions

  • GET /v1/transactions

3) HMAC Headers (Required for /v1/*)

Merchant must send:

  • X-Transacty-Key
  • X-Transacty-Signature
  • X-Transacty-Timestamp

Signature payload format:

<timestamp>.<raw_json_body>

Hash algorithm:

HMAC-SHA256 with merchant secret.

4) Important Notes for Merchants

  • Use transactionId from Transacty as your main reference.
  • platformOrderId is provider-side reference (for support/escalation).
  • Do not call any payment provider directly from merchant integration.
  • Poll GET /v1/payins/:id or GET /v1/payouts/:id when you need the latest status.

5) Super Quick Test (Merchant)

  1. GET /v1/me
  2. GET /v1/balance
  3. POST /v1/payins
  4. Complete payer step from paymentInfo.content
  5. GET /v1/payins/:id until success
  6. POST /v1/payouts
  7. GET /v1/payouts/:id until final state
Overview