Skip to main content

Wallet Refunds

info

Please note that refunds can only be made for pay-ins, and will be to the same destination where the pay-in originated. The destination for a refund cannot be changed.

For a full overview of Refunds visit our dedicated page

The GraphQL API URL https://api.stitch.money/graphql can be used for all refund requests (whether on test or live clients).

Refunds for wallet payments can be completed using the ID of the original payment.

tip

The originalPaymentId input in the mutation accepts either a Apple Pay, Samsung Pay or Google Pay™ transaction ID.

Creating a Wallet Refund

Retrieving All Refunds

Should you want to list all refunds attempted on your client, you can run the following query, provided you have a client token with the client_refund scope.

Querying a Refund by ID

You can use the following query to retrieve a specific refund by its id

Querying a Refund by Nonce

You can use the following query to retrieve a specific refund by its nonce. This query can be useful in situations where your system was unable to store the Stitch ID during a refund mutation attempt, but you still have the unique nonce that was supplied with the mutation.

Querying Refunds by State

You can also further refine the above query to only fetch refunds in a certain state. For example, the below query will list all refunds in the state TransactionFailure. For more options, you can filter at the top level on the refunds node, as in the example below.