Pull Requests

Create a card asynchronously

Create a pull request.

POST https://api.walleo.io/partners/v1/pull_requests

Creates a new pull request.

Request Body

Name	Type	Description
amount*	Integer	The amount of the gift card
gift_card_code*	String	The code of the gift card
request_id*	String	Request ID of pull request

Response

200: OK Pull request created

{
  "pull_request": {
    "id": "3db15189-ef10-49b4-8265-58e3fe946ffb",
    "status": "waiting",
    "request_id": "your_request_id",
    "amount_cents": 5000,
    "created_at": "2024-02-05T11:33:39.999+01:00",
    "updated_at": "2024-02-05T11:33:39.999+01:00",
    "card": null
  }
}

Errors

404: Not Found Gift card not found

{
  "errors": [
    {
      "code": "gift_card_not_found",
      "message": "Gift card not found with code 'IKEA-FR'"
    }
  ],
  "status": "not_found"
}

422: Unprocessable Entity Not enough funds

{
  "errors": [                       
    {
      "code": "not_enough_funds",            
      "message": "Your balance account is not high enough" 
    }                                            
  ],                                             
  "status": "unprocessable_entity"               
}

422: Unprocessable Entity Out of stock

{
  "errors": [                       
    {
      "code": "out_of_stock",            
      "message": "Out of stock gift card 'IKEA-FR'" 
    }                                            
  ],                                             
  "status": "unprocessable_entity"               
}

422: Unprocessable Entity Invalid amount (sku doesn't exist)

{
  "errors": [                       
    {
      "code": "invalid_amount",            
      "message": "Amount must be one of 15, 30 or 100." 
    }                                            
  ],                                             
  "status": "unprocessable_entity"               
}

422: Unprocessable Entity Invalid amount (invalid range)

{
  "errors": [                       
    {
      "code": "invalid_amount",            
      "message": "Amount must be within range from 20 to 500 with steps of 10." 
    }                                            
  ],                                             
  "status": "unprocessable_entity"               
}

401: Unauthorized Unauthorized

{
  "errors": [
    {
      "code": "unauthorized",
      "message": "Not authorized"
    }
  ],
  "status": "unauthorized"
}

401: Unauthorized Invalid signature

{
  "errors": [
    {
      "code": "invalid_signature",
      "message": "Your request does not match your signature"
    }
  ],
  "status": "unauthorized"
}

422: Unprocessable Entity Request ID already used

{
  "errors": [                       
    {
      "code": "unprocessable_entity",            
      "message": "Request id is already used" 
    }                                            
  ],                                             
  "status": "unprocessable_entity"               
}

Show pull request

Show pull request.

GET https://api.walleo.io/partners/v1/pull_requests/:request_id

Show pull request details.

Path Parameters

Name	Type	Description
request_id*	String	Request ID of pull request

Response

200: OK Pull request successfully found

{
  "pull_request": {
    "id": "3db15189-ef10-49b4-8265-58e3fe946ffb",
    "status": "success",
    "request_id": "your_request_id",
    "created_at": "2024-02-05T11:33:39.999+01:00",
    "updated_at": "2024-02-05T11:33:41.488+01:00",
    "card": {
      "id": "4fe88e46-eb22-436c-91ec-6bf874fcf2ae",
      "code": "345454545451154154",
      "expire_at": "2022-06-24T00:00:00.000+02:00",
      "pin_code": "1234",
      "amount": 50,
      "gift_card_code": "IKEA",
      "pdf_url": "https://url.pdf"
    }
  }
}

Errors

404: Not Found Pull request not found

{
  "errors": [
    {
      "code": "pull_request_not_found",
      "message": "Pull request not found with request_id: REQ-ID-TEST"
    }
  ],
  "status": "not_found"
}