Pawn2ME:Development

From XcelData Wiki
Revision as of 19:39, 18 January 2019 by Charliej (talk | contribs) (Replaced content with "{{InDev}} {{Pawn2ME:Development/APIv3}}")
Jump to: navigation, search

This article documents features that are still in development.

Information may change rapidly as the event progresses, or if requirements change. The last updates to this article may not reflect the most current information.


Pawn2ME Version 3 API Calls

All calls require a store api key. That can be done by an admin via accounts.xceldata.com

/v3/authenticate/send

This endpoint is used to verify the api key. It will also return the name of the store.

Note: There are no changes from v1/v2 as of 1/18/2019

POST -> https://api.pawn2me.com/v3/authenticate/send

{ "token": "1E17162A-8355-4FF2-8DCD-E5CEE676FD93" }

Result:

{ "success": true, "key": "1E17162A-8355-4FF2-8DCD-E5CEE676FD93", "store": "DEMO 1 STORE A" }

/v3/customers/signup-user

In order to use Pawn2ME, customers must first verify their device by activating it, per store.

This endpoint tells the server to send an activation link to a specific sms/email address.

A customer cannot receive notices before activating.

Note: There are no changes from v2 as of 1/18/2019

POST -> https://api.pawn2me.com/v3/customers/signup-user

{ "token": "1E17162A-8355-4FF2-8DCD-E5CEE676FD93", "address-type": "sms", "address": "5551234567", "first-name": "Test", "last-name": "Testerson", "id": "D1234567", "language-type": "en", "language-type": "en", "country-code": "1" }

Result:

{ "success": true, "id": "D1234567", "address": "5551234567", "address-country-code": "1" }

/v3/customers/get-updates

This endpoint allows you to know which of your customers are activated or not.

Recording this information allows you to notify the teller that a user is signed up with Pawn2ME and with what account.

The user must have authorized their device to show up as activated. You will only see the activation status of people who signed up at your store.

Note: There are no changes from v2 as of 1/18/2019

POST -> https://api.pawn2me.com/v3/customers/get-updates

{ "token": "1E17162A-8355-4FF2-8DCD-E5CEE676FD93" }

Result:

{ "success": true, "updates": [ { "id": "D1111111", "added": "2018-02-06 18:06:21", "updated": "2018-02-06 18:14:32", "activated": true, "device": { "type": "sms", "address": "5551234567" } }, { "id": "D9999999", "added": "2018-02-07 23:10:02",


/v3/notices/confirm-batch

In order to send a batch it must be confirmed.

This endpoint tells the server to actually allow sending notices to the previously submitted batch number.

Note: There are no changes from v1 as of 1/18/2019

POST -> /v3/notices/confirm-batch

{ "token": "1E17162A-8355-4FF2-8DCD-E5CEE676FD93", "batch-no": "9" }

Result:

{ "success": true, "count": 58 }