This is the unified execution endpoint for the Paybis Send API. It serves two distinct purposes depending on the operation mode:

Payouts (payment_execute): Initiates a crypto transfer from your prefunded balance to a user.
Pay-ins (pay_in_execute): Registers an incoming transaction and generates a unique blockchain deposit address for the user.

The behavior of the endpoint is controlled by the name parameter in the request body.

Payouts (Send Crypto)

Use this mode when you want to send cryptocurrency to a user's wallet. This operation debits your prefunded balance.

Event Name: payment_execute
Prerequisite: Requires a valid quote_id for a Buy direction (Fiat → Crypto).
Key Action: Validates the quote and immediately broadcasts the transaction to the blockchain.

Request Body (`payment_execute`)

Field	Type	Description
`event_id`	UUID	Unique identifier for idempotency.
`name`	String	Must be set to `payment_execute`.
`timestamp`	Date-Time	Request timestamp.
`payment`	Object	Container for payment details.
`payment.transaction`	Object	Contains amounts and your internal IDs (`id`, `order_id`, `merchant`).
`payment.crypto_destination`	Object	Contains the recipient's `crypto_address` and `user_id`.

Example Request:

{
  "event_id": "uuid-1234-5678",
  "name": "payment_execute",
  "timestamp": "2025-10-27T10:00:00Z",
  "payment": {
    "transaction": {
      "id": "tx-internal-001",
      "order_id": "order-001",
      "quote_id": "uuid-quote-id",
      "merchant": "MerchantName",
      "fiat": { "amount": "100.00", "currency": "USD" },
      "crypto": { "amount": "0.05", "currency": "ETH" }
    },
    "crypto_destination": {
      "type": "constant_user",
      "crypto_address": "0x123...",
      "user": { "user_id": "user-001" }
    }
  }
}

Pay-ins (Receive Crypto)

Use this mode when you want to accept a crypto deposit from a user. This operation generates a deposit address and prepares your system to credit your ledger upon receipt.

Event Name: pay_in_execute
Prerequisite: Requires a valid quote_id for a Sell direction (Crypto → Fiat).
Key Action: Locks the sell rate and returns a blockchain_address where the user must send funds.

Request Body (`pay_in_execute`)

Field	Type	Description
`event_id`	UUID	Unique identifier for idempotency.
`name`	String	Must be set to `pay_in_execute`.
`timestamp`	Date-Time	Request timestamp.
`pay_in`	Object	Container for pay-in details.
`pay_in.id`	String	Your internal transaction identifier.
`pay_in.quote_id`	UUID	The sell quote ID obtained previously.
`pay_in.fiat`	Object	The fiat amount/currency expected (must match quote).
`pay_in.crypto`	Object	The crypto amount/currency expected (must match quote).

Example Request:

{
  "event_id": "uuid-9876-5432",
  "name": "pay_in_execute",
  "timestamp": "2025-10-27T10:00:00Z",
  "pay_in": {
    "id": "tx-in-001",
    "quote_id": "uuid-sell-quote-id",
    "fiat": { "amount": "500.00", "currency": "EUR" },
    "crypto": { "amount": "0.015", "currency": "BTC" }
  }
}

Response

The response format also varies based on the executed event, but always contains a status and result object.

📘
Please note that the blockchain address will be returned only in the webhook or event information (but in some cases it may be null).