v4

latestOpenAPI 3.1.02026-08-08186985685.3 KB
redeem

(EVM only) Send Redeem Transaction with Credits Authorization Message

Endpoint to send a credits redeem transaction on EVM-based blockchains.

This endpoint processes a gasless transaction for redeeming credits. It requires a signed permit message (contained in signedMessages.permitCredits) that was previously generated by the /evm/creditsAuthMsg endpoint.

How It Works:

  • Validates that the provided signed permit (EIP-712 signature) is correct.
  • Constructs the transaction using provided details and sends it through the appropriate EVM network provider.

Request Body:

  • merchantId (string): The ID of the merchant.
  • subtotal (Subtotal): The transaction subtotal.
  • transactionData (EvmTransactionData): Details of the transaction to be executed.
  • signedMessages (SignedMessages): Contains the signed permit message (permitCredits) for credit authorization.
  • chargebackProtectionData? (CartItemClassOmitted): Optional chargeback protection data.
  • validBefore, nonce, creditsRawAmount: Values returned by /evm/creditsAuthMsg for further verification.

Response: Returns an object containing:

  • hash (string): The transaction hash of the submitted gasless transaction.
post/redeem/evm/sendGaslessTx

Headers

x-coinflow-auth-walletstring required
x-device-idstring

Optional device identifier provided in the request header.

Request body

merchantIdstring required

The ID of the merchant requesting redemption.

validBeforestring required

Values returned from getEvmCreditsAuthMsg endpoint

noncestring required
creditsRawAmountnumber double required

Response

Ok

hashstring required