curl --request POST \
--url https://vibe-api.liquidramp.com/v1/orders/{reference}/fulfill \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"reference": "bank-tx-ref-001"
}
'{
"status": true,
"message": "<string>",
"data": {
"reference": "<string>",
"merchant_reference": "<string>",
"customer_reference": "<string>",
"type": "onramp",
"from": {
"currency": "<string>",
"network": "<string>",
"amount": 123
},
"to": {
"currency": "<string>",
"network": "<string>",
"amount": 123
},
"pricing": {
"base_currency": "<string>",
"quote_currency": "<string>",
"exchange_rate": 123
},
"fee": {
"currency": "<string>",
"network_fee": 123,
"protocol_fee": 123,
"partner_fee": 123,
"vat": 123,
"total": 123,
"fee_in_rate": true
},
"metadata": {},
"amount_paid": 123,
"amount_settled": 123,
"amount_refunded": 123,
"percentage_settled": 123,
"status": "initiated",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"recipient": {
"institution_code": "<string>",
"account_number": "<string>",
"account_name": "<string>",
"memo": "<string>"
},
"payin": {
"currency": "<string>",
"account_name": "<string>",
"account_number": "<string>",
"institution_code": "<string>",
"amount": 123,
"tx_reference": "<string>",
"expires_at": "2023-11-07T05:31:56Z",
"paid_at": "2023-11-07T05:31:56Z"
},
"payout": [
{
"currency": "<string>",
"account_name": "<string>",
"account_number": "<string>",
"institution_code": "<string>",
"amount": 123,
"percentage": 123,
"tx_reference": "<string>",
"paid_at": "2023-11-07T05:31:56Z"
}
],
"refund": {
"currency": "<string>",
"account_name": "<string>",
"account_number": "<string>",
"institution_code": "<string>",
"amount": 123,
"tx_reference": "<string>",
"refunded_at": "2023-11-07T05:31:56Z"
},
"timeline": [
{
"group": "<string>",
"event": "<string>",
"details": "<unknown>",
"created_at": "2023-11-07T05:31:56Z"
}
]
},
"meta": {
"total": 123,
"per_page": 123,
"current_page": 123,
"last_page": 123
}
}{
"status": false,
"code": "E_VALIDATION_ERROR",
"message": "recipient: recipient is required"
}Orders
Submit optional pay-in proof
Payment is auto-detected. Call this endpoint only if confirmation is delayed.
Submit proof against the order reference.
- Fiat pay-in (onramp):
{ "reference": "bank-tx-ref", "institution": "gtbank" } - Crypto pay-in (offramp/swap):
{ "tx_hash": "0x..." }
Auth: Secret key + HMAC.
Optional include query param matches GET order (payout, timeline).
POST
/
v1
/
orders
/
{reference}
/
fulfill
curl --request POST \
--url https://vibe-api.liquidramp.com/v1/orders/{reference}/fulfill \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"reference": "bank-tx-ref-001"
}
'{
"status": true,
"message": "<string>",
"data": {
"reference": "<string>",
"merchant_reference": "<string>",
"customer_reference": "<string>",
"type": "onramp",
"from": {
"currency": "<string>",
"network": "<string>",
"amount": 123
},
"to": {
"currency": "<string>",
"network": "<string>",
"amount": 123
},
"pricing": {
"base_currency": "<string>",
"quote_currency": "<string>",
"exchange_rate": 123
},
"fee": {
"currency": "<string>",
"network_fee": 123,
"protocol_fee": 123,
"partner_fee": 123,
"vat": 123,
"total": 123,
"fee_in_rate": true
},
"metadata": {},
"amount_paid": 123,
"amount_settled": 123,
"amount_refunded": 123,
"percentage_settled": 123,
"status": "initiated",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"recipient": {
"institution_code": "<string>",
"account_number": "<string>",
"account_name": "<string>",
"memo": "<string>"
},
"payin": {
"currency": "<string>",
"account_name": "<string>",
"account_number": "<string>",
"institution_code": "<string>",
"amount": 123,
"tx_reference": "<string>",
"expires_at": "2023-11-07T05:31:56Z",
"paid_at": "2023-11-07T05:31:56Z"
},
"payout": [
{
"currency": "<string>",
"account_name": "<string>",
"account_number": "<string>",
"institution_code": "<string>",
"amount": 123,
"percentage": 123,
"tx_reference": "<string>",
"paid_at": "2023-11-07T05:31:56Z"
}
],
"refund": {
"currency": "<string>",
"account_name": "<string>",
"account_number": "<string>",
"institution_code": "<string>",
"amount": 123,
"tx_reference": "<string>",
"refunded_at": "2023-11-07T05:31:56Z"
},
"timeline": [
{
"group": "<string>",
"event": "<string>",
"details": "<unknown>",
"created_at": "2023-11-07T05:31:56Z"
}
]
},
"meta": {
"total": 123,
"per_page": 123,
"current_page": 123,
"last_page": 123
}
}{
"status": false,
"code": "E_VALIDATION_ERROR",
"message": "recipient: recipient is required"
}Authorizations
Bearer sk_* plus required headers:
- liquidramp-client-id
- liquidramp-timestamp (unix ms)
- liquidramp-signature (sha256=...)
Path Parameters
Query Parameters
⌘I