Skip to main content
Points does not currently ship a separate hand-maintained Postman collection. The recommended approach is to import the OpenAPI file directly.

​
Import the API into Postman

  1. Open Postman
  2. Click Import
  3. Choose File
  4. Select openapi/points-api-v1.yaml
  5. Let Postman generate the collection
This gives you all documented endpoints with request bodies and schemas generated from the same API reference shown in docs. Create a Postman environment with:
VariableExample
base_urlhttps://api.papp.sa/api/v1
api_keyYour Private key
public_keyYour Public key
order_uuid550e8400-e29b-41d4-a716-446655440000
webhook_uuid550e8400-e29b-41d4-a716-446655440000

​
Suggested first requests

Run these in order:
  1. POST /orders/earning
  2. GET /orders/{orderUuid}
  3. POST /webhooks
  4. GET /webhooks
  5. POST /orders/{orderUuid}/cancel or refund on a test order

​
Helpful request templates

​
Authenticated headers

{
  "x-api-key": "{{api_key}}",
  "Accept": "application/json",
  "Content-Type": "application/json"
}

​
Public checkout request

Use: 
POST {{base_url}}/orders/checkout/{{public_key}}
This request should not include x-api-key.

​
Team workflow recommendation

  • keep one shared collection in your team workspace
  • keep separate environments for sandbox and production
  • never store real production keys in exported collections
  • mask secret environment variables inside Postman