Integrate with Paycrest using the Sender API for initiating payment orders via REST API.
ℹ️ Note: Paycrest currently supports stablecoin-to-fiat (offramp) transactions only. Fiat-to-stablecoin (onramp) is coming in Q3 2025.In this guide, we demonstrate how to enable off-ramps for users with the Sender API. The main difference between the Sender API and the Gateway contract is that users get a receiving address to pay for rather than connecting their non-custodial wallets. This means users can off-ramp directly from any wallet.
API Key
from your sender dashboard.
Visit your Sender Dashboard to retrieve your API Key
and API Secret
. If you’re a new user, sign up as a “sender” and complete our Know-Your-Business (KYB) process. Your API Secret
should always be kept secret - we’ll get to this later in the article.
feePercent
, feeAddress
, and refundAddress
across the tokens and blockchain networks you intend to use.
API Key
in the “API-Key” header of every request you make to Paycrest Offramp API.
401: Unauthorized
.
amount
, senderFee
, and transactionFee
as returned in the order response.payment_order.pending
- Order created, waiting for provider assignmentpayment_order.validated
- Funds have been sent to recipient’s bank/mobile network (value transfer confirmed)payment_order.expired
- Order expired without completionpayment_order.settled
- Order fully completed on blockchainpayment_order.refunded
- Funds refunded to sendervalidated
, expired
, or refunded
.
validated
status, since this indicates funds have been sent to the recipient’s bank/mobile network. The settled
status occurs when the provider has received the stablecoin on-chain, which is separate from the sender-to-recipient money flow.