GET
/purchaserequest/
/purchaserequest/{Id}
https://[api-endpoint-environment]/purchaserequest/
{Id}
This endpoint can be used to poll for change to the purchase request status while awaiting for the Approved/Declined response. You will only need to use this endpoint in the event that the merchant setup requires a user confirmation step and a 'Pending' state is returned from the 'create purchase request' response. The state can transition to one of the following statuses based on user/system actions:
- Pending: Awaiting for the user to approve or cancel the purchase request
- Approved: The customers funds have been captured
- Cancelled:The user has decided to cancel the transaction
- Declined: The user was declined from performing the transaction by Zip
- Expired: The purchase request has expired and can no longer be used
RESPONSE
{
"id": 155216,
"locationId": 5070,
"refCode": "1OA3A012271",
"status": "Pending",
"reason": null,
"receipt_number": 155216
}