Retrieve refund instruction

Retrieve the current status of a specific refund instruction.

refundInstructionIdstringRequired>=1 character<=36 characters

Unique identifier of the refund instruction.

Successful request. Returns the current status of the requested refund instruction.

refundInstructionIdstring>=1 character<=36 characters

Unique identifier that our gateway assigned to the instruction.

errorMessagestringOptional

Description of the error that caused the instruction to fail.

linkobjectOptional

Object that contains information about a HATEOAS link. If we can’t match a dispute to a transaction, we don’t return a ‘link’ object.

statusenumOptional

Indicates the current status of the instruction.

canceled – The instruction was canceled before it was completed.
completed – The instruction has completed. Use the link to check the resource.
failure – The instruction failed. Check the error message for more information.
inProgress – The instruction is currently in progress.

Allowed values:

1	import requests
2
3	url = "https://api.payroc.com/v1/refund-instructions/a37439165d134678a9100ebba3b29597"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"refundInstructionId": "a37439165d134678a9100ebba3b29597",
3	"link": {
4	"rel": "refund",
5	"method": "GET",
6	"href": "https://api.payroc.com/v1/refunds/CD3HN88U9F"
7	},
8	"status": "completed"
9	}