No description, website, or topics provided.
Switch branches/tags
Clone or download
Latest commit 0fb4b6c Jun 18, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Integrating
ADMIN.md Update ADMIN.md Jan 2, 2018
CREDIT.md
DEBIT.md
ENCRYPTION.md Create ENCRYPTION.md Jun 8, 2017
README.md
STOREDVALUE.md

README.md

Getting Started with Monetary Pay API

Authorization

Authorization is easy, just insert your secret key in the Authorization header:

Authorization: secretKEYGOESHERE

Identification

Let us know who you are! Send your product name and version in the User-Agent header:

User-Agent: AwesomePOS/1.2.3

Content Types

Communicate with us in your favorite content type!

We support the following for Content-Type and Accepts values:

  • application/json
  • application/xml
  • x-www-url-encoded

Transactions

Credit Transactions

Debit Transactions

Stored Value Transactions

Administrative Requests

Success Responses

  • 200 OK Approved Transaction
  • 402 PAYMENT REQUIRED Declined Transaction

Failure Responses

  • 400 BAD REQUEST Invalid Transaction Request
  • 401 UNAUTHORIZED Unauthorized Transaction
  • 404 NOT FOUND Resource Not Found

Example Credit Sale Request

POST https://pay.monetary.co/v1/credit/sale

Authorization: secretKEYGOESHERE
User-Agent: AwesomePOS/1.2.3
Content-Type: application/json
Accept: application/json

{
  "Amount": "1.00",
  "Account": "4242424242424242",
  "Expiration": "1220"
}

Example Credit Sale Response

200 OK

{
  "Status": "Approved",
  "Message": "APPROVAL",
  "Account": "XXXXXXXXXXXX4242",
  "Expiration": "XXXX",
  "Brand": "VISA",
  "AuthCode": "ABC123",
  "RefNo": "123",
  "Amount": "1.00",
  "Authorized": "1.00",
  "Token": "card1ABCDEFG2"
}

Using Tokens

As you can see in the example response above, every successful transaction response will include a Token which you can use in subsequent transactions for that account!

For example, this is how to void the above example sale using the RefNo and Token it returned:

Example Credit Void Request with Token

POST https://pay.monetary.co/v1/credit/sale/123/void

Authorization: secretKEYGOESHERE
User-Agent: AwesomePOS/1.2.3
Content-Type: application/json
Accept: application/json

{
  "Token": "card1ABCDEFG2"
}

Example Credit Void Response with Token

200 OK

{
  "Status": "Approved",
  "Message": "APPROVAL",
  "Account": "XXXXXXXXXXXX4242",
  "Expiration": "XXXX",
  "Brand": "VISA",
  "RefNo": "124",
  "Amount": "1.00",
  "Authorized": "1.00",
  "Token": "card1ABCDEFG2"
}