Refund a Payment Intent
curl --request POST \
--url https://api.staging.blackbird.xyz/flynet/v1/payment_intents/{id}/refundconst options = {method: 'POST'};
fetch('https://api.staging.blackbird.xyz/flynet/v1/payment_intents/{id}/refund', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {method: 'POST'};
fetch('https://api.staging.blackbird.xyz/flynet/v1/payment_intents/{id}/refund', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Payments
Refund a Payment Intent
POST
/
payment_intents
/
{id}
/
refund
Refund a Payment Intent
curl --request POST \
--url https://api.staging.blackbird.xyz/flynet/v1/payment_intents/{id}/refundconst options = {method: 'POST'};
fetch('https://api.staging.blackbird.xyz/flynet/v1/payment_intents/{id}/refund', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {method: 'POST'};
fetch('https://api.staging.blackbird.xyz/flynet/v1/payment_intents/{id}/refund', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Refunds a paid Payment Intent. The customer’s wallet receives the full
original amount back from the merchant wallet. Partial refunds are not
supported in v1.
Auth: OAuth access token.
Example
curl -X POST https://api.staging.blackbird.xyz/flynet/v1/payment_intents/{uuid}/refund \
-H "Authorization: Bearer $ACCESS_TOKEN"
Response
{
"id": "{uuid}",
"object": "payment_intent",
"status": "refunded",
"refunded_at": "2026-05-11T20:10:00Z",
"amount": { "value": "1000000000000000000", "currency": "FLY" }
}
Errors
| Code | Meaning |
|---|---|
400 paymentIntent0003 | Intent is not in a refundable state. |
| 401 | Missing or invalid OAuth bearer. Empty body. |