

Transfer request APIs

Quarters allows you to create transfer requests and provide a way to ask users for approval. Typical flow for transfer requests:

Create a "transfer request". It generates a requestId. It requires user access_token for given user.
User approves or declines the request manually on Quarters user-interface (UI). And quarters server will handle transfers.

Create transfer request for user

POST https://api.pocketfulofquarters/v1/requests

with following parameters:

Parameter	Description
`tokens`	Required Number of quarters to transfer
`description`	Optional Transfer description - will be shown on screen while user approval
`appId`	Required The APP ID you received after registering your application

with following headers:

Parameter	Description
`Authorization`	Required Format - `Bearer <access_token>`

Request example:

curl https://api.pocketfulofquarters/v1/requests \
  -X POST \
  -H 'Authorization: Bearer eyJhbGciOiJIU...vyvQf81plg' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  --data-binary '{"tokens": 10,"description":"Power ups","appId":"Lpk5sPrA7P59HFlN7obS"}'

Response example:

{
  "id": "01be8a20-04bb-11e8-94b8-91a2ba7c5972",
  "tokens": 10,
  "appId": "Lpk5sPrA7P59HFlN7obS",
  "appAddress": "0x1e2aa0184dcde9502568593d6c5da68966a3275a",
  "embedCode": "01be8a20-04bb-11e8-94b8-91a2ba7c5972",
  "description": "Power ups",
  "type": "transfer",
  "endpoint": "/v1/requests/01be8a20-04bb-11e8-94b8-91a2ba7c5972",
  "created": {},
  "userId": "Lpk5sPrA7P59HFlN7obS"
}

Authorization

You can redirect to following URL to get approval from user.

URL to Authorize transfer https://pocketfulofquarters.com/requests/{request_id}?inline=true&firebase_token=foo...bar

URL params	Description
`request_id`	Required Request id from step 1
`firebase_token`	Optional Firebase token only for guest users

Response fields will be in query params in case of redirection, and window.onQuartersCallback in case of iframe.

Response fields:

Field	Description
`txId`	Ethereum transaction hash of quarters transfers
`requestId`	Transfer request id

Transfer quarters (Available only for server-to-server)

POST https://api.pocketfulofquarters.com/v1/accounts/{app-account-address}/transfer

with following url params:

Url params	Description
`app-account-address`	Required App account address. An address which you received after app registrations

with following headers:

Parameter	Description
`Authorization`	Required `Bearer <SERVER-API-KEY>` Server API key which you received after app registrations

with following parameters:

Parameter	Description
`amount`	Required Number of quarters to transfer
`user` or `address`	Required User id or user account's valid address

Request example:

curl https://api.pocketfulofquarters/v1/accounts/0x898...89/transfer \
  -X POST \
  -H 'Authorization: Bearer eyJhbGciOiJIU...vyvQf81plg' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  --data-binary '{"amount":10,"user":"Lpk5sPrA7P59HFlN7obS"}'

Response example:

{
  "requestId": "01be8a20-04bb-11e8-94b8-91a2ba7c5972",
  "txId": "0xd832e7c419869...5918b96"
}

This will yield following response:

Field	Description
`txId`	Ethereum transaction hash of quarters transfers

Auto Approve Transfer Request For Users

Note: At this moment Transfer Auto Approval is not available for everyone, please contact support if you would like to use it.

Note 2: Before trying to auto approve a transfer request for a user. Make sure that the user has approved a normal transaction in prior to your auto approval request.

POST https://api.pocketfulofquarters/v1/requests/<request_id>/autoApprove

with following parameters:

Parameter	Description
`clientId`	Required The APP ID you received after registering your application
`userId`	Required User ID of the user that you are trying to auto approve the request for
`address`	Required User account's valid address

with following headers:

Parameter	Description
`Authorization`	Required Format - `Bearer <access_token>`

Request example:

curl https://api.pocketfulofquarters/v1/requests/<request_id>/autoApprove \
  -X POST \
  -H 'Authorization: Bearer eyJhbGciOiJIU...vyvQf81plg' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  --data-binary '{"clientId": "1c6vP7wNNKkXGxUPBc7k", "userId": "eXa0wTZAelWozJ5l7spJwfPrgU42", "address": "0x2a36ee4bb7be5a66865812693f44d407c3dbe603" }'

Response example:

{
  "requestId": "01be8a20-04bb-11e8-94b8-91a2ba7c5972",
  "txId": "0xd832e7c419869...5918b96"
}