Skip to main content
POST
/
payment_intents
/
{id}
/
refund
Refund a Payment Intent
curl --request POST \
  --url https://api.staging.blackbird.xyz/flynet/v1/payment_intents/{id}/refund
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

CodeMeaning
400 paymentIntent0003Intent is not in a refundable state.
401Missing or invalid OAuth bearer. Empty body.