P3 API Overview ¶

API Authentication ¶

P3 APIs require key-based authentication. APIs and features accessible to each API consumer are defined by the public and/or secret key that the API consumer will use. For each API call, the API consumer must pass an Authorization header (using Basic access authentication), with the API key encoded in Base64 MIME encoding.

Example: Given secret key sk-AAAbA4QasPuGfPAApZWpeh7yT1ZBellDpwKyRk8lBBB:

Authorization: Basic c2stQUFBYkE0UWFzUHVHZlBBQXBaV3BlaDd5VDFaQmVsbERwd0t5Ums4bEJCQg==

Transaction Cut-Off Schedule for Voids and Refunds ¶

Purchases and Captures made through PayMaya P3 can either be voided or refunded.

You can void purchases and captures done on or before 11:59:59 PM (PH Standard Time) cut-off of the same day transaction date, otherwise refunding is your option. You can do multiple and partial refunds for a purchase or capture, as long as the total refund amount does not exceed the full amount of the transaction.

Sample scenarios:

Authorizations made through PayMaya P3 can be voided, but not refunded. Authorizations can be voided as long as the transaction is not past the hold period for P3, and no captures have been made. Refer to Authorization Hold Periods for more details.

PayMaya P3 retains transactions only up to a period of 90 days in its Sandbox environment and 390 days in its Production environment.

3-D Secure Authentication Support ¶

PayMaya P3 supports authorizations for 3-D Secure authenticated e-commerce transactions. However, as PayMaya P3 is only a payment processor, the service does not handle the actual authentication procedure. The 3rd party API consumer is responsible for performing the 3-D Secure authentication leg, including, but not limited to, integrating with its own or a 3rd party merchant plug-in (MPI). The result of the authentication can then be included to e-commerce Sale/Purchase and/or Authorization requests to complete a 3-D Secure authenticated purchase/authorization.

Communication Timeout Setting ¶

The following communication timeout settings are recommended:

In the case of a Read Timeout, the API client may either:

• Call Void Transaction if the transaction is voidable, or

• Call Check Transaction to know if the transaction proceeded. API client may proceed accordingly depending on the response of Check Transaction.

Idempotency and Retransmissions ¶

P3 POST APIs support optional idempotency for retransmissions. Any request with the header X-Idempotency-Key will be checked if it is a first transmission or a retransmission (i.e. there exists a similar request with the same X-Idempotency-Key).

• For first transmissions, processing proceeds as normal

• For retransmissions, the response of the corresponding first transmission is returned. Retransmission responses are marked with the header X-Response-Retransmission set to true.

In the case that a retransmission is sent while a first transmission is still ongoing, a pending response is returned with the HTTP status 202.

{
    "status": "ONGOING",
    "message": "Transaction had been received and is still ongoing"
}

When matching retransmissions against first transmissions, the following details must match.

• requesting party

• header Request-Reference-No

• request method

• request URL

• header X-Idempotency-Key

Note that other parts of the request are not inspected. Only the specified details are used for idempotency matching. When the aforementioned details match, the request is considered a retransmission regardless of other details (like request body and etc.).

Details of first transmissions are kept strictly for 6 hours only for candidate retransmission matching. This feature is intended to be used within short intervals only (generally for retries and retries with backoffs) and thus we recommend to use this only for retransmission intervals guaranteed shorter than 6 hours.

Including Metadata ¶

The Authorizations and Payments API supports adding metadata in the headers of the request message.

Geo-Tagging Requests ¶

To geo-tag a request, add a Latitude header and a Longitude header in decimal degrees (DD) format. For example, a request sent from the United States Capitol would include the following headers:

Latitude: 38.8897
Longitude: -77.0089

Transaction / Scenario Guide ¶

Guide for Different Transaction Types ¶

Depending on the merchant and/or transaction being processed, different request semantics may apply.

Recurring Transactions ¶

A transaction is classified as recurring if it meets the following criteria:

• The merchant needs to charge the consumer on defined intervals / schedule (e.g., every 15th of the month)

• Merchant has secured approval from the consumer that a recurring charge will be placed on the consumer’s mode of payment

Recurring transactions are supported for E-Commerce transactions. In order to perform a recurring transaction:

• Client should process the initial transaction as it would for a normal single transaction. This includes 3-DS authentication, initial authorization with 3-DS values and card security code (CSC), if any.

• For recurring transactions after the initial transaction, the client should perform the transaction with the transaction.frequencyIndicator in the request set to RECURRING. This should no longer include the 3-DS and CSC values.

Note that P3 does not match the recurring transactions with their corresponding original transactions. It is up to the client to ensure that recurring transactions are only performed after a corresponding successful original transaction. Chargebacks may apply for incorrectly processed recurring transactions.

Transactions using Vaulted/Stored Credentials ¶

P3 API clients may opt to store the cardholder’s credit card information (PAN, expiry date) after 1 transaction for use in future transactions (refered to as vaulting). In this case, the P3 API client is reponsible for looking up the credit card information on their own vault (or any logical storage) before performing the authorization via P3 API.

Normally, a vaulted card transaction no longer contains the card security code (CSC). Issuers may decline these transactions more often due to the lack of a secondary authentication mechanism (since both 3-DS and CSC validation are no longer performed). For these transactions, the P3 API client must indicate that the credit card information of the transaction came from its storage by setting the flag payer.fundingInstrument.card.vaulted to true. This allows the issuers to relax their acceptance requirements, since it is assumed that PayMaya and/or the P3 API client has already previously authenticated the cardholder by different means.

Recurring transactions (i.e., transaction.frequencyIndicator = RECURRING) are automatically tagged as vaulted transactions, regardless of the value of payer.fundingInstrument.card.vaulted, since it is assumed that either the merchant or the payment gateway has stored the card credentials for future use.

Indicating Initiator and Intent of an Authorization Transaction ¶

For Authorization and Sale/Purchase transactions, the P3 API client may indicate the initiator and the intent of the transaction using the transaction.initiator and transaction.intent fields, respectively. The transaction initiator is the entity that initiated the authorization request, while the transaction intent is a general description of the purpose of the authorization request. The value of these fields may be used by Issuers when determining the approval status of an authorization transaction.

Initiators ¶

The following initiators are supported by the API:

• CONSUMER - (default value) Indicates that the consumer initiated the transaction (e.g., consumer explicitly purchased an item from the merchant)

• MERCHANT - Indicates that the merchant initiated the transaction (e.g., charging subsequent miscellaneous fees after the original transaction)

If not specified, P3 API assumes that the transaction was initiated by the CONSUMER.

Intents ¶

The following intents are supported by the API:

• PAYMENT - (default value) Indicates that the authorization request is being done to collect payment from the consumer for goods/services rendered.

• VAULTING - Indicates that the P3 API client intends to store the consumer’s credentials after a successful authorization. Normally, authorizations with the VAULTING intent are voided/refunded afterwards, as the results are only used for validating the consumer’s credentials. This value should be set even if the client intends to collect payment from the authorization request as well, as long as the client intends to store the credentials afterwards.

If not specified, P3 API assumes that the transaction is intended for PAYMENT.

Recurring transactions (i.e., transaction.frequencyIndicator = RECURRING) are automatically tagged as merchant-initiated transactions, regardless of the value of transaction.initiator, since it is assumed that the consumer is no longer presenting the authorization credentials in these types of transactions.

Payment Transaction Models ¶

Transaction Models ¶

P3 supports 2 models for payment transactions:

• Purchase / Sale

• Authorization + Capture

The following shows the differences in the lifecycle of a payment for both models made through P3:

Purchase / Sale ¶

In Purchase / Sale model, successful purchase transactions are automatically included at the end of the day’s batch processing for clearing. In the case of cancellation, a purchase transaction may either be voided (if cancelling on the same day of the purchase transaction) or refunded (if cancelling on succeeding days after the purchase transaction).

The following APIs can be used in this model:

• /p3/pay - Purchase / Sale

• /p3/void - Void Purchase

• /p3/refund - Refund Purchase

Authorization + Capture ¶

In Authorization + Capture model, payment transactions are done in two parts:

1. Authorization - Authorize and reserve the availability of funds for the transaction. The issuer will only authorize and reserve the funds for the transaction. The cardholder will not be billed until the transaction gets cleared.

2. Capture - Completes the Authorization transaction, and informs PayMaya that the transaction is ready to be cleared. Captured transactions are included at the end of the day’s batch processing for clearing. The cardholder will be billed upon successful clearing of a captured transaction.

This is useful for merchants that have delayed fulfillment processes and wants to synchronize the lifecycle of the payment with the goods and/or services being offered. For example, a merchant running an e-commerce platform may do an authorization as soon as the customer performs “checkout” of the goods, but only capture the payment as soon as availability of the items have been confirmed.

The following APIs can be used in this model:

• /p3/authorize - Authorization

• /p3/capture - Capture

• /p3/void - Void Authorization or Void Capture

• /p3/refund - Refund Capture

Authorization Types ¶

• NORMAL Indicates a Normal Authorization transaction, this authorization request can be captured and cleared for amounts less than or equal to the authorization amount.

• FINAL Indicates a Final Authorization transaction, this authorization request can be only be captured and cleared for amounts equal to the authorization amount (i.e., partial captures are not supported).

• PREAUTHORIZATION Indicates a Preauthorization transaction, this authorization request can be captured and cleared for amounts greater than (not yet supported), less than, or equal to the authorization amount. On certain conditions, a preauthorization may have longer hold periods than normal authorizations. Please refer to Authorization Hold Periods for more details.

Authorization Hold Periods ¶

A successful Authorization is saved (held) by P3 until the transaction is not past its hold period. Authorizations past their corresponding hold period that do not have successful captures, or were not voided, will be automatically voided by P3, resulting to the authorization hold being dropped.

The following table summarizes the authorization hold periods defined by P3 depending on certain conditions:

^A - For Visa, pre-authorized transactions can have longer hold periods (29 days) if the following conditions are met:

• Merchant falls under one of the ff categories:
  • Lodging (e.g. hotels, resorts, lodging reservation systems)
  • Vehicle Rental
  • Cruise Lines

It is up to the P3 API Client to ensure that authorizations are successfully captured before the hold period expires for the transactions to be included in the settlement for the merchant.

Test Configuration ¶

The following accounts / data can be used for testing the API calls documented here.

Merchants ¶

Secret Keys ¶

Test Cards ¶

Web APIs ¶

Content-Type: application/json
Request-Reference-No: A1D099C2-2479-4AAC-9F87-B2A304450PAY
Authorization: Basic c2stYVhRZG9yT09GMHpHTWZ5VkF6VEg5Q2JBRnZxcTFPYzdQQVhjRGxyejV6eg==
X-Idempotency-Key: d5aec741-fff3-47d8-bfd9-04c2348bc970
Latitude: 38.8897
Longitude: -77.0089

{
  "merchant": {
    "id": "EFS100001033",
    "metadata": {
      "refNo": "ORDER-123954"
    },
    "paymentFacilitator": {
      "subMerchants": [
        {
          "id": "SUBMER01",
          "metadata": {
            "refNo": "ORDER-123954"
          },
          "name": "Leslie's Record Bar",
          "address": {
            "alphaCountryCode": "PHL",
            "city": "Mandaluyong",
            "line1": "6F Launchpad Reliance St",
            "postalCode": "1535",
            "state": "Metro Manila"
          },
          "mcc": "5999",
          "contactNo": "09191234567"
        }
      ]
    }
  },
  "payer": {
    "metadata": {
      "ipAddress": "127.0.0.1"
    },
    "fundingInstrument": {
      "card": {
        "cardNumber": "5457210001000019",
        "expiryMonth": "12",
        "expiryYear": "2025",
        "firstName": "TEST",
        "lastName": "CARD",
        "csc": "050",
        "type": "CREDIT",
        "account": "DEFAULT",
        "vaulted": false,
        "tokenId": "897d5691-7036-443d-8fa5-5a66387a593d"
      }
    }
  },
  "transaction": {
    "initiator": "CONSUMER",
    "intent": "PAYMENT",
    "amount": {
      "total": {
        "currency": "PHP",
        "value": 10.5
      }
    },
    "frequencyIndicator": "SINGLE",
    "description": "Purchased goods and services"
  },
  "options": {
    "threeDSecure": {
      "verificationToken": "jqEmJkhI2+SDCAAAAAAJBwAAAAA=",
      "eci": "05",
      "enrolled": "Y",
      "authenticationStatus": "Y"
    }
  },
  "trace": {
    "batchNo": "000001",
    "traceNo": "000001"
  }
}

{
  "$schema": "http://json-schema.org/draft-06/schema#",
  "type": "object",
  "properties": {
    "merchant": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique ID issued by PayMaya to the merchant."
        },
        "metadata": {
          "type": "object",
          "properties": {
            "refNo": {
              "type": "string",
              "limit": "1..36",
              "pattern": "*",
              "description": "(OPTIONAL) Reference number of the merchant for the transaction."
            }
          },
          "description": "(OPTIONAL) Transaction-specific metadata for the merchant involved"
        },
        "paymentFacilitator": {
          "type": "object",
          "properties": {
            "subMerchants": {
              "type": "array",
              "properties": {
                "id": {
                  "type": "string",
                  "limit": "1..15",
                  "pattern": "[-a-zA-Z_0-9]+"
                },
                "metadata": {
                  "type": "object",
                  "properties": {
                    "refNo": {
                      "type": "string",
                      "limit": "1..36",
                      "pattern": "*",
                      "description": "(OPTIONAL) Reference number of the merchant for the transaction."
                    }
                  },
                  "description": "(OPTIONAL) Transaction-specific metadata for the merchant involved"
                },
                "name": {
                  "type": "string",
                  "limit": "1..22",
                  "pattern": "[-' .,a-zA-Z_0-9]+"
                },
                "mcc": {
                  "type": "string",
                  "limit": "1..15",
                  "pattern": "^[0-9]{1,15}$"
                },
                "address": {
                  "type": "object",
                  "properties": {
                    "line1": {
                      "type": "string",
                      "limit": "1..25"
                    },
                    "city": {
                      "type": "string",
                      "limit": "1..25"
                    },
                    "state": {
                      "type": "string"
                    },
                    "postalCode": {
                      "type": "string",
                      "limit": "1..10",
                      "pattern": "^[a-zA-Z0-9-_ ]{1,10}$"
                    },
                    "alphaCountryCode": {
                      "type": "string",
                      "limit": "3",
                      "pattern": "^[A-Z]{3}$",
                      "description": "ISO-3166-1 Alpha-3 Country Code of the address"
                    }
                  }
                },
                "contactNo": {
                  "type": "string",
                  "limit": "1..15",
                  "pattern": "^\\+?[0-9]{1,15}$"
                }
              }
            }
          },
          "description": "(OPTIONAL) Information about the Payment Facilitator (if the merchant is a Payment Facilitator) and the sub-merchant performing the transaction."
        }
      },
      "description": "Information about the merchant performing the request for the cardholder."
    },
    "payer": {
      "type": "object",
      "properties": {
        "metadata": {
          "type": "object",
          "description": "Metadata about the cardholder",
          "properties": {
            "ipAddress": {
              "type": "string",
              "description": "IP address being used by the cardholder to transact"
            }
          }
        },
        "fundingInstrument": {
          "type": "object",
          "properties": {
            "card": {
              "type": "object",
              "properties": {
                "cardNumber": {
                  "type": "string",
                  "description": "Personal Account Number (PAN) of the card used by the cardholder"
                },
                "expiryMonth": {
                  "type": "string",
                  "limit": "1..2",
                  "pattern": "0?[1-9]|1[0-2]",
                  "description": "Numeric format of the month (MM) when the card was set by the issuer to expire"
                },
                "expiryYear": {
                  "type": "string",
                  "limit": "4..4",
                  "pattern": "[\\d]{4}",
                  "description": "Numeric format of the year when (YYYY) the card was set by the issuer to expire"
                },
                "firstName": {
                  "type": "string",
                  "description": "(OPTIONAL) First name of the cardholder"
                },
                "lastName": {
                  "type": "string",
                  "description": "(OPTIONAL) Last name of the cardholder"
                },
                "csc": {
                  "type": "string",
                  "pattern": "[\\d]{3}",
                  "description": "(OPTIONAL) Card Security Code (CSC) / Card Verification Value (CVV) of the card"
                },
                "billingAddress": {
                  "type": "object",
                  "properties": {
                    "line1": {
                      "type": "string",
                      "limit": "1..25",
                      "description": "(OPTIONAL) Line 1 of the address field"
                    },
                    "city": {
                      "type": "string",
                      "limit": "1..25",
                      "description": "(OPTIONAL) City"
                    },
                    "state": {
                      "type": "string",
                      "description": "(OPTIONAL) State"
                    },
                    "postalCode": {
                      "type": "string",
                      "limit": "1..10",
                      "pattern": "^[a-zA-Z0-9-_ ]{1,10}$",
                      "description": "(OPTIONAL) Postal / ZIP Code"
                    },
                    "alphaCountryCode": {
                      "type": "string",
                      "limit": "3",
                      "pattern": "^[A-Z]{3}$",
                      "description": "(OPTIONAL) ISO-3166-1 Alpha-3 Country Code of the address"
                    }
                  },
                  "description": "(OPTIONAL) Billing address of the cardholder"
                },
                "type": {
                  "type": "string",
                  "description": "(OPTIONAL) Indicates the type of the card used for the transaction",
                  "enum": [
                    "CREDIT",
                    "DEBIT"
                  ]
                },
                "account": {
                  "type": "string",
                  "description": "(OPTIONAL) Indicates the type of the account used for the transaction (default: DEFAULT)",
                  "enum": [
                    "DEFAULT",
                    "SAVINGS",
                    "CURRENT",
                    "CREDIT"
                  ]
                },
                "vaulted": {
                  "type": "boolean",
                  "description": "(OPTIONAL) Indicates whether or not the card information was previously stored by the API caller, and the stored card information was used in this transaction. (default: false)"
                },
                "tokenId": {
                  "type": "string",
                  "description": "Gateway-assigned token ID of the card being used to transact"
                }
              }
            }
          }
        },
        "referenceId": {
          "type": "string",
          "description": "Gateway-assigned ID of the cardholder"
        }
      },
      "description": "Information about the cardholder where the source of funds for the transaction will come from."
    },
    "transaction": {
      "type": "object",
      "properties": {
        "initiator": {
          "type": "string",
          "enum": [
            "CONSUMER",
            "MERCHANT"
          ],
          "description": "(OPTIONAL) Identifies the initiator of the transaction. (default: CONSUMER)"
        },
        "intent": {
          "type": "string",
          "enum": [
            "PAYMENT",
            "VAULTING"
          ],
          "description": "(OPTIONAL) Identifies the intent of the transaction. (default: PAYMENT)"
        },
        "amount": {
          "type": "object",
          "properties": {
            "total": {
              "type": "object",
              "properties": {
                "currency": {
                  "type": "string"
                },
                "value": {
                  "type": "number"
                }
              }
            }
          }
        },
        "frequencyIndicator": {
          "type": "string",
          "enum": [
            "SINGLE - One-time transaction (default)",
            "RECURRING - Recurring transaction"
          ]
        },
        "description": {
          "type": "string",
          "limit": "0..512",
          "pattern": "[-a-zA-Z_0-9 .,]+"
        }
      },
      "description": "Information about the transaction being performed."
    },
    "options": {
      "type": "object",
      "properties": {
        "threeDSecure": {
          "type": "object",
          "properties": {
            "xid": {
              "type": "string",
              "limit": "28..28",
              "description": "(OPTIONAL) A unique transaction identifier generated by the MPI on behalf of the merchant to identify the 3-DS transaction, in `Base64` encoding."
            },
            "eci": {
              "type": "string",
              "enum": [
                "00 - (MasterCard) Unauthenticated transaction",
                "01 - (MasterCard) Merchant or Issuer attempted to authenticate the cardholder, but the authentication was not successful (e.g., card is not 3-DS enrolled)",
                "02 - (MasterCard) Issuer successfully authenticated the cardholder",
                "05 - (Visa, JCB) Issuer successfully authenticated the cardholder",
                "06 - (Visa, JCB) Merchant or Issuer attempted to authenticate the cardholder, but the authentication was not successful (e.g., card is not 3-DS enrolled)",
                "07 - (Visa, JCB) Unauthenticated transaction"
              ],
              "description": "3-D Secure Electronic Commerce Indicator (ECI)."
            },
            "verificationToken": {
              "type": "string",
              "limit": "28..28",
              "description": "(OPTIONAL) Value generated by the card issuer as a token to prove that the cardholder authentication was successful, in `Base64` encoding."
            },
            "enrolled": {
              "type": "string",
              "enum": [
                "Y - Yes, card is enrolled",
                "N - No, card is NOT enrolled",
                "U - Status of card enrollment is unavailable for checking"
              ],
              "description": "Indicates whether the card is enrolled for 3-D Secure. Defaults to U.",
              "default": "U"
            },
            "authenticationStatus": {
              "type": "string",
              "enum": [
                "Y - Cardholder was successfully authenticated",
                "A - Authentication was attempted",
                "N - Cardholder authentication failed",
                "U - Unavailable for checking"
              ],
              "description": "Information whether the card authentication was successful or not. Defaults to U.",
              "default": "U"
            },
            "dsTransactionId": {
              "type": "string",
              "description": "Directory Server Transaction ID"
            },
            "messageVersion": {
              "type": "string",
              "description": "Message version used for transaction authentication.",
              "pattern": "^[0-9]+[.][0-9]+[.][0-9]+$",
              "examples": [
                "1.0.0",
                "2.1.0"
              ]
            }
          },
          "description": " (OPTIONAL) Used for 3-D Secure (3-DS) Pre-Authenticated purchase transactions. Indicates the 3-D Secure parameters / response data returned by the Merchant Plug-In (MPI). Merchant is required to send this field if a 3-DS authentication attempt was performed before the purchase transaction.",
          "required": [
            "eci"
          ]
        }
      },
      "description": "(OPTIONAL) Additional options for the payment transaction"
    },
    "trace": {
      "type": "object",
      "properties": {
        "batchNo": {
          "type": "string",
          "limit": "1..8",
          "pattern": "[A-Za-z0-9]{1,8}",
          "description": "(OPTIONAL, alphanum) batch of authorizations where the transaction is included"
        },
        "traceNo": {
          "type": "string",
          "limit": "1..6",
          "pattern": "[A-Za-z0-9]{1,6}",
          "description": "(OPTIONAL, alphanum) terminal-generated number for this transaction"
        }
      },
      "description": "(OPTIONAL) Values supplied by the transaction originator / terminal that can be used for reconciliation of transactions"
    }
  }
}

Content-Type: application/json

{
  "paymentTransactionReferenceNo": "02c8edb3-301a-4ce6-a8b2-cbcf37dbd5b5",
  "status": "SUCCESS",
  "createdAt": "2017-05-31T10:15:28.677Z",
  "receipt": {
    "transactionId": "01234567ABCD",
    "approvalCode": "000167",
    "batchNo": "20170601",
    "traceNo": "000001",
    "receiptNo": "805322262599"
  },
  "payer": {
    "fundingInstrument": {
      "card": {
        "cardNumber": "4761340000000043",
        "expiryMonth": "12",
        "expiryYear": "2022",
        "firstName": "SMART E MONEY",
        "lastName": "INC",
        "csc": "050",
        "billingAddress": {
          "alphaCountryCode": "PHL",
          "city": "Mandaluyong",
          "line1": "6F Launchpad Reliance St",
          "postalCode": "1535",
          "state": "Metro Manila"
        }
      }
    }
  },
  "amount": {
    "total": {
      "currency": "PHP",
      "value": 10.5
    }
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "paymentTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number for the purchase request generated by P3. Merchants should keep track of this value for use in succeeding Void Purchase or Refund Purchase requests."
    },
    "status": {
      "type": "string",
      "description": "*DEPRECATED*. Indicates the result of the transaction. Merchants should no longer rely on this field for the actual transaction status, and should rely on the HTTP status code and the existence of a reference number as the indicator of a successful transaction."
    },
    "createdAt": {
      "type": "string",
      "description": "Local time of the host when the transaction was processed."
    },
    "receipt": {
      "type": "object",
      "properties": {
        "transactionId": {
          "type": "string",
          "description": "Unique identifier returned by the issuer for this transaction."
        },
        "approvalCode": {
          "type": "string",
          "description": "Approval Code / Authorization Identification Code generated by the issuer to indicate the approval of a transaction"
        },
        "batchNo": {
          "type": "string",
          "description": "(alphanum, 8) Value supplied by P3, or the value of `transaction.trace.batchNo` during the request (if supplied), which indicates the batch of transactions that the specific transaction has been grouped with. Merchants may keep track of this value for reconnaissance."
        },
        "traceNo": {
          "type": "string",
          "description": "(alphanum, 8) Value of `transaction.trace.traceNo` during the request (if supplied)"
        },
        "receiptNo": {
          "type": "string",
          "description": "(alphanum, 12) A receipt / reference number generated by the acquirer. Can be used by all parties (cardholder, merchant, payment gateway, acquirer, issuer) when looking up a specific transaction record for reconnaisance."
        }
      },
      "description": "Additional transaction reference numbers generated by either the issuing bank or the acquiring host."
    },
    "payer": {
      "type": "object",
      "properties": {
        "fundingInstrument": {
          "type": "object",
          "properties": {
            "card": {
              "type": "object",
              "properties": {
                "cardNumber": {
                  "type": "string",
                  "description": "Personal Account Number (PAN) of the card used by the cardholder"
                },
                "expiryMonth": {
                  "type": "string",
                  "limit": "1..2",
                  "pattern": "0?[1-9]|1[0-2]",
                  "description": "Numeric format of the month (MM) when the card was set by the issuer to expire"
                },
                "expiryYear": {
                  "type": "string",
                  "limit": "4..4",
                  "pattern": "[\\d]{4}",
                  "description": "Numeric format of the year when (YYYY) the card was set by the issuer to expire"
                },
                "firstName": {
                  "type": "string",
                  "description": "First name of the cardholder"
                },
                "lastName": {
                  "type": "string",
                  "description": "Last name of the cardholder"
                },
                "csc": {
                  "type": "string",
                  "pattern": "[\\d]{3}",
                  "description": "Card Security Code of the card"
                },
                "billingAddress": {
                  "type": "object",
                  "properties": {
                    "line1": {
                      "type": "string",
                      "limit": "1..25"
                    },
                    "city": {
                      "type": "string",
                      "limit": "1..25"
                    },
                    "state": {
                      "type": "string"
                    },
                    "postalCode": {
                      "type": "string",
                      "limit": "1..10",
                      "pattern": "^[0-9]{1,10}$"
                    },
                    "alphaCountryCode": {
                      "type": "string",
                      "limit": "3",
                      "pattern": "^[A-Z]{3}$",
                      "description": "ISO-3166-1 Alpha-3 Country Code of the address"
                    }
                  },
                  "description": "Billing address of the cardholder"
                }
              }
            }
          }
        }
      },
      "description": "Information about the cardholder where the source of funds for the transaction will come from."
    },
    "amount": {
      "type": "object",
      "properties": {
        "total": {
          "type": "object",
          "properties": {
            "currency": {
              "type": "string"
            },
            "value": {
              "type": "number"
            }
          }
        }
      },
      "description": "amount authorized for the transaction"
    }
  }
}

Content-Type: application/json
Request-Reference-No: A1D099C2-2479-4AAC-9F87-B2A304450PAY
Authorization: Basic c2stYVhRZG9yT09GMHpHTWZ5VkF6VEg5Q2JBRnZxcTFPYzdQQVhjRGxyejV6eg==
X-Idempotency-Key: aaf47701-da90-4f72-803f-7fbf72d6b5f7
Latitude: 38.8897
Longitude: -77.0089

{
  "merchant": {
    "id": "EFS100001149",
    "metadata": {
      "refNo": "ORDER-123954"
    },
    "acquiringTerminal": {
      "id": "PYMYPOS1",
      "inputCapability": {
        "keyEntry": true,
        "magstripeReader": true,
        "emvChip": true,
        "contactless": true,
        "contactlessMagstripe": true
      },
      "posEntryMode": {
        "panEntry": "05",
        "pinEntry": "0"
      },
      "onMerchantPremise": true,
      "terminalAttended": true,
      "cardCaptureSupported": false,
      "cardholderActivatedTerminal": true
    }
  },
  "payer": {
    "fundingInstrument": {
      "card": {
        "cardNumber": "4761340000000043",
        "expiryMonth": "12",
        "expiryYear": "2022",
        "firstName": "SMART E MONEY",
        "lastName": "INC",
        "cardPresentFields": {
          "cardSeqNum": "001",
          "emvIccData": "ggIcAIQHoAAAAAMQEJUFgAAAAACaAxcEGZwBAF8qAgYInwIGAAAAAAEAnwMGAAAAAAAAnxASBgEKA6CAAAoCAAAAAABuefOZnxoCBgifHghQWU1ZUE9TMZ8mCA5/WLUnW3KxnycBgJ8zAyAgyJ80Ax4DAJ81ASGfNgIAyp83BKOXolWfQQQAAAAB",
          "track2": ";4834427000590355=19092010000000000914?2"
        },
        "type": "CREDIT",
        "account": "DEFAULT",
        "pin": {
          "block": "8B79206EF0F5D02B",
          "format": "ISO-0",
          "keyId": "F33900F3-7115-4F1F-ADD2-B5D02E9721E9"
        }
      }
    }
  },
  "transaction": {
    "initiator": "CONSUMER",
    "intent": "PAYMENT",
    "amount": {
      "total": {
        "currency": "PHP",
        "value": 10.5
      }
    },
    "frequencyIndicator": "SINGLE",
    "description": "Purchased goods and services"
  },
  "trace": {
    "batchNo": "000001",
    "traceNo": "000001"
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "merchant": {
      "type": "object",
      "properties": {
        "metadata": {
          "type": "object",
          "properties": {
            "refNo": {
              "type": "string",
              "limit": "1..36",
              "pattern": "*",
              "description": "(OPTIONAL) Reference number of the merchant for the transaction."
            }
          },
          "description": "(OPTIONAL) Transaction-specific metadata for the merchant involved"
        },
        "id": {
          "type": "string",
          "description": "Unique ID issued by PayMaya to the merchant."
        },
        "acquiringTerminal": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "limit": "1..36",
              "pattern": "[-a-zA-Z_0-9]+",
              "description": "Unique ID of the terminal."
            },
            "inputCapability": {
              "type": "object",
              "properties": {
                "keyEntry": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal has a keypad (physical or electronic) to accept manual input of card data (default: false)"
                },
                "magstripeReader": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal supports reading of contact magnetic stripe cards (swipe) (default: false)"
                },
                "emvChip": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal supports reading of contact chip cards (dip) (default: false)"
                },
                "contactless": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal supports reading of contactless chip cards (tap) (default: false)"
                },
                "contactlessMagstripe": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal supports reading of contactless magnetic stripe chip cards (tap) (default: false)"
                }
              },
              "description": "Indicates the capabilities of the terminal that read the card"
            },
            "posEntryMode": {
              "type": "object",
              "properties": {
                "panEntry": {
                  "type": "string",
                  "enum": [
                    "00 - PAN Entry Mode is unknown (default)",
                    "01 - Manual Entry",
                    "02 - Magnetic stripe read, but full unaltered contents not provided",
                    "05 - PAN auto entry via chip",
                    "07 - Auto-entry via contactless magnetic chip",
                    "79 - Chip card at chip-capable terminal was unable to process transaction using data on the chip or magnetic stripe on the card - therefore, PAN entry via manual entry",
                    "80 - Chip card at chip-capable terminal was unable to process transaction using data on the chip therefore the terminal defaulted to the magnetic stripe read for the PAN. This is referred to as fallback.",
                    "90 - Magnetic stripe read and full, unaltered contents provided",
                    "91 - Auto-entry via contactless magnetic strip"
                  ],
                  "description": "Indicates how the card's PAN was entered into the terminal at the time of the transaction"
                },
                "pinEntry": {
                  "type": "string",
                  "enum": [
                    "0 - Unspecified or Unknown  (default)",
                    "1 - Terminal has PIN entry capability",
                    "2 - Terminal does not have PIN entry capability",
                    "8 - Terminal has PIN entry capability but PIN pad is not currently operative."
                  ],
                  "description": "Indicates the terminal's PIN input capability at the time of the transaction"
                }
              },
              "description": "Indicates how the card was actually read by the terminal"
            },
            "onMerchantPremise": {
              "type": "boolean",
              "description": "Indicates whether or not the terminal is within the merchant's area of control"
            },
            "terminalAttended": {
              "type": "boolean",
              "description": "Indicates whether or not the merchant directly attends to the terminal"
            },
            "cardCaptureSupported": {
              "type": "boolean",
              "description": "Indicates whether or not the terminal has capabilities to capture (store) cards upon directive from the issuer"
            },
            "cardholderActivatedTerminal": {
              "type": "boolean",
              "description": "Indicates whether or not the cardholder activates and initiates transactions on the terminal directly instead of the merchant"
            },
            "type": {
              "type": "string",
              "description": "Indicates the type of terminal being used for the transaction",
              "enum": [
                "POS",
                "MPOS",
                "ATM",
                "IN_TRANSIT",
                "IN_FLIGHT"
              ]
            }
          },
          "description": "(OPTIONAL) Information about the terminal used to read the contents of a card."
        }
      },
      "description": "Information about the merchant performing the request for the cardholder."
    },
    "payer": {
      "type": "object",
      "properties": {
        "fundingInstrument": {
          "type": "object",
          "properties": {
            "card": {
              "type": "object",
              "properties": {
                "cardNumber": {
                  "type": "string",
                  "description": "Personal Account Number (PAN) of the card used by the cardholder"
                },
                "expiryMonth": {
                  "type": "string",
                  "limit": "1..2",
                  "pattern": "0?[1-9]|1[0-2]",
                  "description": "Numeric format of the month (MM) when the card was set by the issuer to expire"
                },
                "expiryYear": {
                  "type": "string",
                  "limit": "4..4",
                  "pattern": "[\\d]{4}",
                  "description": "Numeric format of the year when (YYYY) the card was set by the issuer to expire"
                },
                "firstName": {
                  "type": "string",
                  "description": "First name of the cardholder"
                },
                "lastName": {
                  "type": "string",
                  "description": "Last name of the cardholder"
                },
                "cardPresentFields": {
                  "type": "object",
                  "properties": {
                    "cardSeqNum": {
                      "type": "string",
                      "limit": "3..3",
                      "pattern": "[0-9]{3}+",
                      "description": "Sequence number of the card read from the chip. Only present for EMV/chip-based transactions."
                    },
                    "emvIccData": {
                      "type": "string",
                      "limit": "1..340",
                      "description": "EMV ICC binary data read from the card, in Base64 encoding."
                    },
                    "track1": {
                      "type": "string",
                      "description": "Track 1 (magnetic stripe) data as read from the card. For chip cards, provided by \"Track 1 Equivalent Data\" read from the chip."
                    },
                    "track2": {
                      "type": "string",
                      "description": "Track 2 (magnetic stripe) data as read from the card. For chip cards, provided by \"Track 2 Equivalent Data\" read from the chip."
                    }
                  },
                  "description": "Details of the card read by a terminal (for card present transactions)"
                },
                "type": {
                  "type": "string",
                  "description": "(OPTIONAL) Indicates the type of the card used for the transaction",
                  "enum": [
                    "CREDIT",
                    "DEBIT"
                  ]
                },
                "account": {
                  "type": "string",
                  "description": "(OPTIONAL) Indicates the type of the account used for the transaction (default: DEFAULT)",
                  "enum": [
                    "DEFAULT",
                    "SAVINGS",
                    "CURRENT",
                    "CREDIT"
                  ]
                },
                "pin": {
                  "block": {
                    "type": "string",
                    "description": "PIN block encrypted under the PIN encryption key"
                  },
                  "format": {
                    "type": "string",
                    "description": "Format of the PIN block as generated by the terminal",
                    "enum": [
                      "ISO-0 - ISO 9564-1 & ANSI X9.8 format 0",
                      "ISO-1 - ISO 9564-1 format 1",
                      "ISO-3 - ISO 9564-1 & ANSI X9.8 format 3"
                    ]
                  },
                  "keyId": {
                    "type": "string",
                    "description": "Key ID of the encryption key used to encrypt the PIN block"
                  }
                }
              }
            }
          }
        }
      },
      "description": "Information about the cardholder where the source of funds for the transaction will come from."
    },
    "transaction": {
      "type": "object",
      "properties": {
        "initiator": {
          "type": "string",
          "enum": [
            "CONSUMER",
            "MERCHANT"
          ],
          "description": "(OPTIONAL) Identifies the initiator of the transaction. (default: CONSUMER)"
        },
        "intent": {
          "type": "string",
          "enum": [
            "PAYMENT",
            "VAULTING"
          ],
          "description": "(OPTIONAL) Identifies the intent of the transaction. (default: PAYMENT)"
        },
        "amount": {
          "type": "object",
          "properties": {
            "total": {
              "type": "object",
              "properties": {
                "currency": {
                  "type": "string"
                },
                "value": {
                  "type": "number"
                }
              }
            }
          }
        },
        "frequencyIndicator": {
          "type": "string",
          "enum": [
            "SINGLE - One-time transaction (default)",
            "RECURRING - Recurring transaction"
          ]
        },
        "description": {
          "type": "string",
          "limit": "0..512",
          "pattern": "[-a-zA-Z_0-9 .,]+"
        }
      },
      "description": "Information about the transaction being performed."
    },
    "trace": {
      "type": "object",
      "properties": {
        "batchNo": {
          "type": "string",
          "limit": "1..8",
          "pattern": "[A-Za-z0-9]{1,8}",
          "description": "(OPTIONAL, alphanum) batch of authorizations where the transaction is included"
        },
        "traceNo": {
          "type": "string",
          "limit": "1..6",
          "pattern": "[A-Za-z0-9]{1,6}",
          "description": "(OPTIONAL, alphanum) terminal-generated number for this transaction"
        }
      },
      "description": "(OPTIONAL) Values supplied by the transaction originator / terminal that can be used for reconciliation of transactions"
    }
  }
}

Content-Type: application/json

{
  "paymentTransactionReferenceNo": "02c8edb3-301a-4ce6-a8b2-cbcf37dbd5b5",
  "status": "SUCCESS",
  "createdAt": "2017-05-31T10:15:28.677Z",
  "receipt": {
    "transactionId": "01234567ABCD",
    "approvalCode": "000167",
    "batchNo": "20170601",
    "traceNo": "000001",
    "receiptNo": "805322262599"
  },
  "payer": {
    "fundingInstrument": {
      "card": {
        "cardNumber": "4761340000000043",
        "expiryMonth": "12",
        "expiryYear": "2022",
        "firstName": "SMART E MONEY",
        "lastName": "INC",
        "cardPresentFields": {
          "cardSeqNum": "001",
          "emvIccData": "ggIcAIQHoAAAAAMQEJUFgAAAAACaAxcEGZwBAF8qAgYInwIGAAAAAAEAnwMGAAAAAAAAnxASBgEKA6CAAAoCAAAAAABuefOZnxoCBgifHghQWU1ZUE9TMZ8mCA5/WLUnW3KxnycBgJ8zAyAgyJ80Ax4DAJ81ASGfNgIAyp83BKOXolWfQQQAAAAB",
          "track2": ";4834427000590355=19092010000000000914?2"
        }
      }
    }
  },
  "amount": {
    "total": {
      "currency": "PHP",
      "value": 10.5
    }
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "paymentTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number for the purchase request generated by P3. Merchants should keep track of this value for use in succeeding Void Purchase or Refund Purchase requests."
    },
    "status": {
      "type": "string",
      "description": "*DEPRECATED*. Indicates the result of the transaction. Merchants should no longer rely on this field for the actual transaction status, and should rely on the HTTP status code and the existence of a reference number as the indicator of a successful transaction."
    },
    "createdAt": {
      "type": "Calendar",
      "description": "Local time of the host when the transaction was processed."
    },
    "receipt": {
      "type": "object",
      "properties": {
        "transactionId": {
          "type": "string",
          "description": "Unique identifier returned by the issuer for this transaction."
        },
        "approvalCode": {
          "type": "string",
          "description": "Approval Code / Authorization Identification Code generated by the issuer to indicate the approval of a transaction"
        },
        "batchNo": {
          "type": "string",
          "description": "(alphanum, 8) Value supplied by P3, or the value of `transaction.trace.batchNo` during the request (if supplied), which indicates the batch of transactions that the specific transaction has been grouped with. Merchants may keep track of this value for reconnaissance."
        },
        "traceNo": {
          "type": "string",
          "description": "(alphanum, 8) Value of `transaction.trace.traceNo` during the request (if supplied)"
        },
        "receiptNo": {
          "type": "string",
          "description": "(alphanum, 12) A receipt / reference number generated by the acquirer. Can be used by all parties (cardholder, merchant, payment gateway, acquirer, issuer) when looking up a specific transaction record for reconnaisance."
        }
      },
      "description": "Additional transaction reference numbers generated by either the issuing bank or the acquiring host."
    },
    "payer": {
      "type": "object",
      "properties": {
        "fundingInstrument": {
          "type": "object",
          "properties": {
            "card": {
              "type": "object",
              "properties": {
                "cardNumber": {
                  "type": "string",
                  "description": "Personal Account Number (PAN) of the card used by the cardholder"
                },
                "expiryMonth": {
                  "type": "string",
                  "limit": "1..2",
                  "pattern": "0?[1-9]|1[0-2]",
                  "description": "Numeric format of the month (MM) when the card was set by the issuer to expire"
                },
                "expiryYear": {
                  "type": "string",
                  "limit": "4..4",
                  "pattern": "[\\d]{4}",
                  "description": "Numeric format of the year when (YYYY) the card was set by the issuer to expire"
                },
                "firstName": {
                  "type": "string",
                  "description": "First name of the cardholder"
                },
                "lastName": {
                  "type": "string",
                  "description": "Last name of the cardholder"
                }
              }
            }
          }
        }
      },
      "description": "Information about the cardholder where the source of funds for the transaction will come from."
    },
    "authorizationData": {
      "emvIccData": {
        "type": "string",
        "limit": "1..340",
        "description": "EMV ICC binary data returned by the Issuer. To be used for post-processing (e.g., Issuer Authentication by EMV EXTERNAL AUTHENTICATE or 2nd GENERATE AC)"
      }
    },
    "amount": {
      "type": "object",
      "properties": {
        "total": {
          "type": "object",
          "properties": {
            "currency": {
              "type": "string"
            },
            "value": {
              "type": "number"
            }
          }
        }
      },
      "description": "amount authorized for the transaction"
    }
  }
}

Content-Type: application/json
Request-Reference-No: A1D099C2-2479-4AAC-9F87-B2A304450PAY
Authorization: Basic c2stYVhRZG9yT09GMHpHTWZ5VkF6VEg5Q2JBRnZxcTFPYzdQQVhjRGxyejV6eg==

{
  "merchant": {
    "id": "EFS100001149",
    "metadata": {
      "refNo": "ORDER-123954"
    },
    "acquiringTerminal": {
      "id": "PYMYPOS1",
      "inputCapability": {
        "keyEntry": true,
        "magstripeReader": true,
        "emvChip": true,
        "contactless": true,
        "contactlessMagstripe": true
      },
      "posEntryMode": {
        "panEntry": "05",
        "pinEntry": "0"
      },
      "onMerchantPremise": true,
      "terminalAttended": true,
      "cardCaptureSupported": false,
      "cardholderActivatedTerminal": true
    }
  },
  "payer": {
    "fundingInstrument": {
      "paymaya": {
        "fundSourceId": "06c8b27a-2d78-4d24-8473-d0ab81fd66ec"
      }
    }
  },
  "transaction": {
    "initiator": "CONSUMER",
    "intent": "PAYMENT",
    "amount": {
      "total": {
        "currency": "PHP",
        "value": 10.5
      }
    },
    "frequencyIndicator": "SINGLE",
    "description": "Purchased goods and services"
  },
  "trace": {
    "batchNo": "000001",
    "traceNo": "000001"
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "merchant": {
      "type": "object",
      "properties": {
        "metadata": {
          "type": "object",
          "properties": {
            "refNo": {
              "type": "string",
              "limit": "1..36",
              "pattern": "*",
              "description": "(OPTIONAL) Reference number of the merchant for the transaction."
            }
          },
          "description": "(OPTIONAL) Transaction-specific metadata for the merchant involved"
        },
        "id": {
          "type": "string",
          "description": "Unique ID issued by PayMaya to the merchant."
        },
        "acquiringTerminal": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "limit": "1..36",
              "pattern": "[-a-zA-Z_0-9]+",
              "description": "Unique ID of the terminal."
            },
            "inputCapability": {
              "type": "object",
              "properties": {
                "keyEntry": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal has a keypad (physical or electronic) to accept manual input of card data (default: false)"
                },
                "magstripeReader": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal supports reading of contact magnetic stripe cards (swipe) (default: false)"
                },
                "emvChip": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal supports reading of contact chip cards (dip) (default: false)"
                },
                "contactless": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal supports reading of contactless chip cards (tap) (default: false)"
                },
                "contactlessMagstripe": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal supports reading of contactless magnetic stripe chip cards (tap) (default: false)"
                }
              },
              "description": "Indicates the capabilities of the terminal that read the card"
            },
            "posEntryMode": {
              "type": "object",
              "properties": {
                "panEntry": {
                  "type": "string",
                  "enum": [
                    "00 - PAN Entry Mode is unknown (default)",
                    "01 - Manual Entry",
                    "02 - Magnetic stripe read, but full unaltered contents not provided",
                    "05 - PAN auto entry via chip",
                    "07 - Auto-entry via contactless magnetic chip",
                    "79 - Chip card at chip-capable terminal was unable to process transaction using data on the chip or magnetic stripe on the card - therefore, PAN entry via manual entry",
                    "80 - Chip card at chip-capable terminal was unable to process transaction using data on the chip therefore the terminal defaulted to the magnetic stripe read for the PAN. This is referred to as fallback.",
                    "90 - Magnetic stripe read and full, unaltered contents provided",
                    "91 - Auto-entry via contactless magnetic strip"
                  ],
                  "description": "Indicates how the card's PAN was entered into the terminal at the time of the transaction"
                },
                "pinEntry": {
                  "type": "string",
                  "enum": [
                    "0 - Unspecified or Unknown  (default)",
                    "1 - Terminal has PIN entry capability",
                    "2 - Terminal does not have PIN entry capability",
                    "8 - Terminal has PIN entry capability but PIN pad is not currently operative."
                  ],
                  "description": "Indicates the terminal's PIN input capability at the time of the transaction"
                }
              },
              "description": "Indicates how the card was actually read by the terminal"
            },
            "onMerchantPremise": {
              "type": "boolean",
              "description": "Indicates whether or not the terminal is within the merchant's area of control"
            },
            "terminalAttended": {
              "type": "boolean",
              "description": "Indicates whether or not the merchant directly attends to the terminal"
            },
            "cardCaptureSupported": {
              "type": "boolean",
              "description": "Indicates whether or not the terminal has capabilities to capture (store) cards upon directive from the issuer"
            },
            "cardholderActivatedTerminal": {
              "type": "boolean",
              "description": "Indicates whether or not the cardholder activates and initiates transactions on the terminal directly instead of the merchant"
            },
            "type": {
              "type": "string",
              "description": "Indicates the type of terminal being used for the transaction",
              "enum": [
                "POS",
                "MPOS",
                "ATM",
                "IN_TRANSIT",
                "IN_FLIGHT"
              ]
            }
          },
          "description": "(OPTIONAL) Information about the terminal used to read the contents of a card."
        }
      },
      "description": "Information about the merchant performing the request for the cardholder."
    },
    "payer": {
      "type": "object",
      "properties": {
        "fundingInstrument": {
          "type": "object",
          "properties": {
            "paymaya": {
              "type": "object",
              "properties": {
                "fundSourceId": {
                  "type": "string",
                  "description": "Fund Source ID associated to the PayMaya account used to initiate the transaction"
                }
              }
            }
          }
        }
      },
      "description": "Information about the cardholder where the source of funds for the transaction will come from."
    },
    "transaction": {
      "type": "object",
      "properties": {
        "initiator": {
          "type": "string",
          "enum": [
            "CONSUMER",
            "MERCHANT"
          ],
          "description": "(OPTIONAL) Identifies the initiator of the transaction. (default: CONSUMER)"
        },
        "intent": {
          "type": "string",
          "enum": [
            "PAYMENT",
            "VAULTING"
          ],
          "description": "(OPTIONAL) Identifies the intent of the transaction. (default: PAYMENT)"
        },
        "amount": {
          "type": "object",
          "properties": {
            "total": {
              "type": "object",
              "properties": {
                "currency": {
                  "type": "string"
                },
                "value": {
                  "type": "number"
                }
              }
            }
          }
        },
        "frequencyIndicator": {
          "type": "string",
          "enum": [
            "SINGLE - One-time transaction (default)",
            "RECURRING - Recurring transaction"
          ]
        },
        "description": {
          "type": "string",
          "limit": "0..512",
          "pattern": "[-a-zA-Z_0-9 .,]+"
        }
      },
      "description": "Information about the transaction being performed."
    },
    "trace": {
      "type": "object",
      "properties": {
        "batchNo": {
          "type": "string",
          "limit": "1..8",
          "pattern": "[A-Za-z0-9]{1,8}",
          "description": "(OPTIONAL, alphanum) batch of authorizations where the transaction is included"
        },
        "traceNo": {
          "type": "string",
          "limit": "1..6",
          "pattern": "[A-Za-z0-9]{1,6}",
          "description": "(OPTIONAL, alphanum) terminal-generated number for this transaction"
        }
      },
      "description": "(OPTIONAL) Values supplied by the transaction originator / terminal that can be used for reconciliation of transactions"
    }
  }
}

Content-Type: application/json

{
  "paymentTransactionReferenceNo": "02c8edb3-301a-4ce6-a8b2-cbcf37dbd5b5",
  "status": "SUCCESS",
  "createdAt": "2017-05-31T10:15:28.677Z",
  "receipt": {
    "transactionId": "01234567ABCD",
    "approvalCode": "000167",
    "batchNo": "20170601",
    "traceNo": "000001",
    "receiptNo": "805322262599"
  },
  "payer": {
    "fundingInstrument": {
      "paymaya": {
        "fundSourceId": "06c8b27a-2d78-4d24-8473-d0ab81fd66ec"
      }
    }
  },
  "amount": {
    "total": {
      "currency": "PHP",
      "value": 10.5
    }
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "paymentTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number for the purchase request generated by P3. Merchants should keep track of this value for use in succeeding Void Purchase or Refund Purchase requests."
    },
    "status": {
      "type": "string",
      "description": "*DEPRECATED*. Indicates the result of the transaction. Merchants should no longer rely on this field for the actual transaction status, and should rely on the HTTP status code and the existence of a reference number as the indicator of a successful transaction."
    },
    "createdAt": {
      "type": "Calendar",
      "description": "Local time of the host when the transaction was processed."
    },
    "receipt": {
      "type": "object",
      "properties": {
        "transactionId": {
          "type": "string",
          "description": "Unique identifier returned by the issuer for this transaction."
        },
        "approvalCode": {
          "type": "string",
          "description": "Approval Code / Authorization Identification Code generated by the issuer to indicate the approval of a transaction"
        },
        "batchNo": {
          "type": "string",
          "description": "(alphanum, 8) Value supplied by P3, or the value of `transaction.trace.batchNo` during the request (if supplied), which indicates the batch of transactions that the specific transaction has been grouped with. Merchants may keep track of this value for reconnaissance."
        },
        "traceNo": {
          "type": "string",
          "description": "(alphanum, 8) Value of `transaction.trace.traceNo` during the request (if supplied)"
        },
        "receiptNo": {
          "type": "string",
          "description": "(alphanum, 12) A receipt / reference number generated by the acquirer. Can be used by all parties (cardholder, merchant, payment gateway, acquirer, issuer) when looking up a specific transaction record for reconnaisance."
        }
      },
      "description": "Additional transaction reference numbers generated by either the issuing bank or the acquiring host."
    },
    "payer": {
      "type": "object",
      "properties": {
        "fundingInstrument": {
          "type": "object",
          "properties": {
            "paymaya": {
              "type": "object",
              "properties": {
                "fundSourceId": {
                  "type": "string",
                  "description": "Fund Source ID associated to the PayMaya account used to initiate the transaction"
                }
              }
            }
          }
        }
      },
      "description": "Information about the cardholder where the source of funds for the transaction will come from."
    },
    "authorizationData": {
      "emvIccData": {
        "type": "string",
        "limit": "1..340",
        "description": "EMV ICC binary data returned by the Issuer. To be used for post-processing (e.g., Issuer Authentication by EMV EXTERNAL AUTHENTICATE or 2nd GENERATE AC)"
      }
    },
    "amount": {
      "type": "object",
      "properties": {
        "total": {
          "type": "object",
          "properties": {
            "currency": {
              "type": "string"
            },
            "value": {
              "type": "number"
            }
          }
        }
      },
      "description": "amount authorized for the transaction"
    }
  }
}

Content-Type: application/json
Request-Reference-No: A1D099C2-2479-4AAC-9F87-B2A304450PAY
Authorization: Basic c2stYVhRZG9yT09GMHpHTWZ5VkF6VEg5Q2JBRnZxcTFPYzdQQVhjRGxyejV6eg==
X-Idempotency-Key: 010ad5fd-a354-4ae3-bb65-5b38892d8fcd
Latitude: 38.8897
Longitude: -77.0089

{
  "authorizationType": "NORMAL",
  "merchant": {
    "id": "EFS100001033",
    "metadata": {
      "refNo": "ORDER-123954"
    },
    "paymentFacilitator": {
      "subMerchants": [
        {
          "id": "SUBMER01",
          "metadata": {
            "refNo": "ORDER-123954"
          },
          "name": "Leslie's Record Bar",
          "address": {
            "alphaCountryCode": "PHL",
            "city": "Mandaluyong",
            "line1": "6F Launchpad Reliance St",
            "postalCode": "1535",
            "state": "Metro Manila"
          },
          "mcc": "5999",
          "contactNo": "09191234567"
        }
      ]
    }
  },
  "payer": {
    "metadata": {
      "ipAddress": "127.0.0.1"
    },
    "fundingInstrument": {
      "card": {
        "cardNumber": "5457210001000019",
        "expiryMonth": "12",
        "expiryYear": "2025",
        "firstName": "TEST",
        "lastName": "Card",
        "csc": "050",
        "type": "CREDIT",
        "account": "DEFAULT",
        "vaulted": false,
        "tokenId": "897d5691-7036-443d-8fa5-5a66387a593d"
      }
    }
  },
  "transaction": {
    "initiator": "CONSUMER",
    "intent": "PAYMENT",
    "amount": {
      "total": {
        "currency": "PHP",
        "value": 10.5
      }
    },
    "frequencyIndicator": "SINGLE",
    "description": "Purchased goods and services"
  },
  "options": {
    "threeDSecure": {
      "verificationToken": "jqEmJkhI2+SDCAAAAAAJBwAAAAA=",
      "eci": "05",
      "enrolled": "Y",
      "authenticationStatus": "Y"
    }
  },
  "trace": {
    "batchNo": "000001",
    "traceNo": "000001"
  }
}

{
  "$schema": "http://json-schema.org/draft-06/schema#",
  "type": "object",
  "properties": {
    "authorizationType": {
      "type": "string",
      "enum": [
        "NORMAL - Normal authorization",
        "FINAL - Final authorization",
        "PREAUTHORIZATION - Preauthorization"
      ],
      "description": "(OPTIONAL) Authorization type. (default: `NORMAL`)"
    },
    "merchant": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique ID issued by PayMaya to the merchant."
        },
        "metadata": {
          "type": "object",
          "properties": {
            "refNo": {
              "type": "string",
              "limit": "1..36",
              "pattern": "*",
              "description": "(OPTIONAL) Reference number of the merchant for the transaction."
            }
          },
          "description": "(OPTIONAL) Transaction-specific metadata for the merchant involved"
        },
        "paymentFacilitator": {
          "type": "object",
          "properties": {
            "subMerchants": {
              "type": "array",
              "properties": {
                "id": {
                  "type": "string",
                  "limit": "1..15",
                  "pattern": "[-a-zA-Z_0-9]+"
                },
                "name": {
                  "type": "string",
                  "limit": "1..22",
                  "pattern": "[-' .,a-zA-Z_0-9]+"
                },
                "mcc": {
                  "type": "string",
                  "limit": "1..15",
                  "pattern": "^[0-9]{1,15}$"
                },
                "address": {
                  "type": "object",
                  "properties": {
                    "line1": {
                      "type": "string",
                      "limit": "1..25"
                    },
                    "city": {
                      "type": "string",
                      "limit": "1..25"
                    },
                    "state": {
                      "type": "string"
                    },
                    "postalCode": {
                      "type": "string",
                      "limit": "1..10",
                      "pattern": "^[a-zA-Z0-9-_ ]{1,10}$"
                    },
                    "alphaCountryCode": {
                      "type": "string",
                      "limit": "3",
                      "pattern": "^[A-Z]{3}$",
                      "description": "ISO-3166-1 Alpha-3 Country Code of the address"
                    }
                  }
                },
                "contactNo": {
                  "type": "string",
                  "limit": "1..15",
                  "pattern": "^\\+?[0-9]{1,15}$"
                }
              }
            }
          },
          "description": "(OPTIONAL) Information about the Payment Facilitator (if the merchant is a Payment Facilitator) and the sub-merchant performing the transaction."
        }
      },
      "description": "Information about the merchant performing the request for the cardholder."
    },
    "payer": {
      "type": "object",
      "properties": {
        "metadata": {
          "type": "object",
          "description": "Metadata about the cardholder",
          "properties": {
            "ipAddress": {
              "type": "string",
              "description": "IP address being used by the cardholder to transact"
            }
          }
        },
        "fundingInstrument": {
          "type": "object",
          "properties": {
            "card": {
              "type": "object",
              "properties": {
                "cardNumber": {
                  "type": "string",
                  "description": "Personal Account Number (PAN) of the card used by the cardholder"
                },
                "expiryMonth": {
                  "type": "string",
                  "limit": "1..2",
                  "pattern": "0?[1-9]|1[0-2]",
                  "description": "Numeric format of the month (MM) when the card was set by the issuer to expire"
                },
                "expiryYear": {
                  "type": "string",
                  "limit": "4..4",
                  "pattern": "[\\d]{4}",
                  "description": "Numeric format of the year when (YYYY) the card was set by the issuer to expire"
                },
                "firstName": {
                  "type": "string",
                  "description": "(OPTIONAL) First name of the cardholder"
                },
                "lastName": {
                  "type": "string",
                  "description": "(OPTIONAL) Last name of the cardholder"
                },
                "csc": {
                  "type": "string",
                  "pattern": "[\\d]{3}",
                  "description": "(OPTIONAL) Card Security Code of the card"
                },
                "billingAddress": {
                  "type": "object",
                  "properties": {
                    "line1": {
                      "type": "string",
                      "limit": "1..25",
                      "description": "(OPTIONAL) Line 1 of the address field"
                    },
                    "city": {
                      "type": "string",
                      "limit": "1..25",
                      "description": "(OPTIONAL) City"
                    },
                    "state": {
                      "type": "string",
                      "description": "(OPTIONAL) State"
                    },
                    "postalCode": {
                      "type": "string",
                      "limit": "1..10",
                      "pattern": "^[a-zA-Z0-9-_ ]{1,10}$",
                      "description": "(OPTIONAL) Postal / ZIP Code"
                    },
                    "alphaCountryCode": {
                      "type": "string",
                      "limit": "3",
                      "pattern": "^[A-Z]{3}$",
                      "description": "(OPTIONAL) ISO-3166-1 Alpha-3 Country Code of the address"
                    }
                  },
                  "description": "(OPTIONAL) Billing address of the cardholder"
                },
                "type": {
                  "type": "string",
                  "description": "(OPTIONAL) Indicates the type of the card used for the transaction",
                  "enum": [
                    "CREDIT",
                    "DEBIT"
                  ]
                },
                "account": {
                  "type": "string",
                  "description": "(OPTIONAL) Indicates the type of the account used for the transaction (default: DEFAULT)",
                  "enum": [
                    "DEFAULT",
                    "SAVINGS",
                    "CURRENT",
                    "CREDIT"
                  ]
                },
                "vaulted": {
                  "type": "boolean",
                  "description": "(OPTIONAL) Indicates whether or not the card information was previously stored by the API caller, and the stored card information was used in this transaction. (default: false)"
                },
                "tokenId": {
                  "type": "string",
                  "description": "Gateway-assigned token ID of the card being used to transact"
                }
              }
            }
          }
        },
        "referenceId": {
          "type": "string",
          "description": "Gateway-assigned ID of the cardholder"
        }
      },
      "description": "Information about the cardholder where the source of funds for the transaction will come from."
    },
    "transaction": {
      "type": "object",
      "properties": {
        "initiator": {
          "type": "string",
          "enum": [
            "CONSUMER",
            "MERCHANT"
          ],
          "description": "(OPTIONAL) Identifies the initiator of the transaction. (default: CONSUMER)"
        },
        "intent": {
          "type": "string",
          "enum": [
            "PAYMENT",
            "VAULTING"
          ],
          "description": "(OPTIONAL) Identifies the intent of the transaction. (default: PAYMENT)"
        },
        "amount": {
          "type": "object",
          "properties": {
            "total": {
              "type": "object",
              "properties": {
                "currency": {
                  "type": "string"
                },
                "value": {
                  "type": "number"
                }
              }
            }
          }
        },
        "frequencyIndicator": {
          "type": "string",
          "enum": [
            "SINGLE - One-time transaction (default)",
            "RECURRING - Recurring transaction"
          ],
          "description": "(OPTIONAL) Indicates if the transaction is a unique, one-shot transactino (SINGLE), or a transaction regularly repeated by the API client, either by time schedule or by other triggers (RECURRING)"
        },
        "description": {
          "type": "string",
          "limit": "0..512",
          "pattern": "[-a-zA-Z_0-9 .,]+"
        }
      },
      "description": "Information about the transaction being performed."
    },
    "options": {
      "type": "object",
      "properties": {
        "threeDSecure": {
          "type": "object",
          "properties": {
            "xid": {
              "type": "string",
              "limit": "28..28",
              "description": "(OPTIONAL) A unique transaction identifier generated by the MPI on behalf of the merchant to identify the 3-DS transaction, in `Base64` encoding."
            },
            "eci": {
              "type": "string",
              "enum": [
                "00 - (MasterCard) Unauthenticated transaction",
                "01 - (MasterCard) Merchant or Issuer attempted to authenticate the cardholder, but the authentication was not successful (e.g., card is not 3-DS enrolled)",
                "02 - (MasterCard) Issuer successfully authenticated the cardholder",
                "05 - (Visa, JCB) Issuer successfully authenticated the cardholder",
                "06 - (Visa, JCB) Merchant or Issuer attempted to authenticate the cardholder, but the authentication was not successful (e.g., card is not 3-DS enrolled)",
                "07 - (Visa, JCB) Unauthenticated transaction"
              ],
              "description": "3-D Secure Electronic Commerce Indicator (ECI)."
            },
            "verificationToken": {
              "type": "string",
              "limit": "28..28",
              "description": "(OPTIONAL) Value generated by the card issuer as a token to prove that the cardholder authentication was successful, in `Base64` encoding."
            },
            "enrolled": {
              "type": "string",
              "enum": [
                "Y - Yes, card is enrolled",
                "N - No, card is NOT enrolled",
                "U - Status of card enrollment is unavailable for checking"
              ],
              "description": "Indicates whether the card is enrolled for 3-D Secure. Defaults to U.",
              "default": "U"
            },
            "authenticationStatus": {
              "type": "string",
              "enum": [
                "Y - Cardholder was successfully authenticated",
                "A - Authentication was attempted",
                "N - Cardholder authentication failed",
                "U - Unavailable for checking"
              ],
              "description": "Information whether the card authentication was successful or not. Defaults to U.",
              "default": "U"
            },
            "dsTransactionId": {
              "type": "string",
              "description": "Directory Server Transaction ID"
            },
            "messageVersion": {
              "type": "string",
              "description": "Message version used for transaction authentication.",
              "pattern": "^[0-9]+[.][0-9]+[.][0-9]+$",
              "examples": [
                "1.0.0",
                "2.1.0"
              ]
            }
          },
          "description": "(OPTIONAL) Used for 3-D Secure (3-DS) Pre-Authenticated purchase transactions. Indicates the 3-D Secure parameters / response data returned by the Merchant Plug-In (MPI). Merchant is required to send this field if a 3-DS authentication attempt was performed before the purchase transaction.",
          "required": [
            "eci"
          ]
        }
      },
      "description": "(OPTIONAL) Additional options for the payment transaction"
    },
    "trace": {
      "type": "object",
      "properties": {
        "batchNo": {
          "type": "string",
          "limit": "1..8",
          "pattern": "[A-Za-z0-9]{1,8}",
          "description": "(OPTIONAL, alphanum) batch of authorizations where the transaction is included"
        },
        "traceNo": {
          "type": "string",
          "limit": "1..6",
          "pattern": "[A-Za-z0-9]{1,6}",
          "description": "(OPTIONAL, alphanum) terminal-generated number for this transaction"
        }
      },
      "description": "(OPTIONAL) Values supplied by the transaction originator / terminal that can be used for reconciliation of transactions"
    }
  }
}

Content-Type: application/json

{
  "paymentTransactionReferenceNo": "02c8edb3-301a-4ce6-a8b2-cbcf37dbd5b5",
  "status": "SUCCESS",
  "createdAt": "2017-05-31T10:15:28.677Z",
  "receipt": {
    "transactionId": "01234567ABCD",
    "approvalCode": "000167",
    "batchNo": "20170601",
    "traceNo": "000001",
    "receiptNo": "805322262599"
  },
  "payer": {
    "fundingInstrument": {
      "card": {
        "cardNumber": "4761340000000043",
        "expiryMonth": "12",
        "expiryYear": "2022",
        "firstName": "SMART E MONEY",
        "lastName": "INC",
        "csc": "050",
        "billingAddress": {
          "alphaCountryCode": "PHL",
          "city": "Mandaluyong",
          "line1": "6F Launchpad Reliance St",
          "postalCode": "1535",
          "state": "Metro Manila"
        }
      }
    }
  },
  "amount": {
    "total": {
      "currency": "PHP",
      "value": 10.5
    }
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "paymentTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number for the purchase request generated by P3. Merchants should keep track of this value for use in succeeding Void Purchase or Refund Purchase requests."
    },
    "status": {
      "type": "string",
      "description": "*DEPRECATED*. Indicates the result of the transaction. Merchants should no longer rely on this field for the actual transaction status, and should rely on the HTTP status code and the existence of a reference number as the indicator of a successful transaction."
    },
    "createdAt": {
      "type": "Calendar",
      "description": "Local time of the host when the transaction was processed."
    },
    "receipt": {
      "type": "object",
      "properties": {
        "transactionId": {
          "type": "string",
          "description": "Unique identifier returned by the issuer for this transaction."
        },
        "approvalCode": {
          "type": "string",
          "description": "Approval Code / Authorization Identification Code generated by the issuer to indicate the approval of a transaction"
        },
        "batchNo": {
          "type": "string",
          "description": "(alphanum, 8) Value supplied by P3, or the value of `transaction.trace.batchNo` during the request (if supplied), which indicates the batch of transactions that the specific transaction has been grouped with. Merchants may keep track of this value for reconnaissance."
        },
        "traceNo": {
          "type": "string",
          "description": "(alphanum, 8) Value of `transaction.trace.traceNo` during the request (if supplied)"
        },
        "receiptNo": {
          "type": "string",
          "description": "(alphanum, 12) A receipt / reference number generated by the acquirer. Can be used by all parties (cardholder, merchant, payment gateway, acquirer, issuer) when looking up a specific transaction record for reconnaisance."
        }
      },
      "description": "Additional transaction reference numbers generated by either the issuing bank or the acquiring host."
    },
    "payer": {
      "type": "object",
      "properties": {
        "fundingInstrument": {
          "type": "object",
          "properties": {
            "card": {
              "type": "object",
              "properties": {
                "cardNumber": {
                  "type": "string",
                  "description": "Personal Account Number (PAN) of the card used by the cardholder"
                },
                "expiryMonth": {
                  "type": "string",
                  "limit": "1..2",
                  "pattern": "0?[1-9]|1[0-2]",
                  "description": "Numeric format of the month (MM) when the card was set by the issuer to expire"
                },
                "expiryYear": {
                  "type": "string",
                  "limit": "4..4",
                  "pattern": "[\\d]{4}",
                  "description": "Numeric format of the year when (YYYY) the card was set by the issuer to expire"
                },
                "firstName": {
                  "type": "string",
                  "description": "First name of the cardholder"
                },
                "lastName": {
                  "type": "string",
                  "description": "Last name of the cardholder"
                },
                "csc": {
                  "type": "string",
                  "pattern": "[\\d]{3}",
                  "description": "Card Security Code of the card"
                },
                "billingAddress": {
                  "type": "object",
                  "properties": {
                    "line1": {
                      "type": "string",
                      "limit": "1..25"
                    },
                    "city": {
                      "type": "string",
                      "limit": "1..25"
                    },
                    "state": {
                      "type": "string"
                    },
                    "postalCode": {
                      "type": "string",
                      "limit": "1..10",
                      "pattern": "^[0-9]{1,10}$"
                    },
                    "alphaCountryCode": {
                      "type": "string",
                      "limit": "3",
                      "pattern": "^[A-Z]{3}$",
                      "description": "ISO-3166-1 Alpha-3 Country Code of the address"
                    }
                  },
                  "description": "Billing address of the cardholder"
                }
              }
            }
          }
        }
      },
      "description": "information about the paying entity. Sensitive information (e.g., card number) may be masked."
    },
    "amount": {
      "type": "object",
      "properties": {
        "total": {
          "type": "object",
          "properties": {
            "currency": {
              "type": "string"
            },
            "value": {
              "type": "number"
            }
          }
        }
      },
      "description": "amount authorized for the transaction"
    }
  }
}

Content-Type: application/json
Request-Reference-No: A1D099C2-2479-4AAC-9F87-B2A304450PAY
Authorization: Basic c2stYVhRZG9yT09GMHpHTWZ5VkF6VEg5Q2JBRnZxcTFPYzdQQVhjRGxyejV6eg==
X-Idempotency-Key: 4a8a97b3-f921-4efe-aa97-e15d98ffe199
Latitude: 38.8897
Longitude: -77.0089

{
  "authorizationType": "NORMAL",
  "merchant": {
    "id": "EFS100001149",
    "metadata": {
      "refNo": "ORDER-123954"
    },
    "acquiringTerminal": {
      "id": "PYMYPOS1",
      "inputCapability": {
        "magstripeReader": true,
        "emvChip": true
      },
      "posEntryMode": {
        "panEntry": "05",
        "pinEntry": "2"
      },
      "onMerchantPremise": true,
      "terminalAttended": true,
      "cardCaptureSupported": false,
      "cardholderActivatedTerminal": true
    }
  },
  "payer": {
    "fundingInstrument": {
      "card": {
        "cardNumber": "4761340000000043",
        "expiryMonth": "12",
        "expiryYear": "2022",
        "firstName": "SMART E MONEY",
        "lastName": "INC",
        "cardPresentFields": {
          "cardSeqNum": "001",
          "emvIccData": "ggIcAIQHoAAAAAMQEJUFgAAAAACaAxcEGZwBAF8qAgYInwIGAAAAAAEAnwMGAAAAAAAAnxASBgEKA6CAAAoCAAAAAABuefOZnxoCBgifHghQWU1ZUE9TMZ8mCA5/WLUnW3KxnycBgJ8zAyAgyJ80Ax4DAJ81ASGfNgIAyp83BKOXolWfQQQAAAAB",
          "track2": ";4834427000590355=19092010000000000914?2"
        },
        "type": "CREDIT",
        "account": "DEFAULT",
        "pin": {
          "block": "B0726345EBF1DEB9",
          "format": "ISO-0",
          "keyId": "F33900F3-7115-4F1F-ADD2-B5D02E9721E9"
        }
      }
    }
  },
  "transaction": {
    "initiator": "CONSUMER",
    "intent": "PAYMENT",
    "amount": {
      "total": {
        "currency": "PHP",
        "value": 10.5
      }
    },
    "frequencyIndicator": "SINGLE",
    "description": "Purchased goods and services"
  },
  "trace": {
    "batchNo": "000001",
    "traceNo": "000001"
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "authorizationType": {
      "type": "string",
      "enum": [
        "NORMAL - Normal authorization",
        "FINAL - Final authorization",
        "PREAUTHORIZATION - Preauthorization"
      ],
      "description": "Authorization type. (default: `NORMAL`)"
    },
    "merchant": {
      "type": "object",
      "properties": {
        "metadata": {
          "type": "object",
          "properties": {
            "refNo": {
              "type": "string",
              "limit": "1..36",
              "pattern": "*",
              "description": "(OPTIONAL) Reference number of the merchant for the transaction."
            }
          },
          "description": "(OPTIONAL) Transaction-specific metadata for the merchant involved"
        },
        "id": {
          "type": "string",
          "description": "Unique ID issued by PayMaya to the merchant."
        },
        "acquiringTerminal": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "limit": "1..36",
              "pattern": "[-a-zA-Z_0-9]+",
              "description": "Unique ID of the terminal."
            },
            "inputCapability": {
              "type": "object",
              "properties": {
                "keyEntry": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal has a keypad (physical or electronic) to accept manual input of card data (default: false)"
                },
                "magstripeReader": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal supports reading of contact magnetic stripe cards (swipe) (default: false)"
                },
                "emvChip": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal supports reading of contact chip cards (dip) (default: false)"
                },
                "contactless": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal supports reading of contactless chip cards (tap) (default: false)"
                },
                "contactlessMagstripe": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal supports reading of contactless magnetic stripe chip cards (tap) (default: false)"
                }
              },
              "description": "Indicates the capabilities of the terminal that read the card"
            },
            "posEntryMode": {
              "type": "object",
              "properties": {
                "panEntry": {
                  "type": "string",
                  "enum": [
                    "00 - PAN Entry Mode is unknown (default)",
                    "01 - Manual Entry",
                    "02 - Magnetic stripe read, but full unaltered contents not provided",
                    "05 - PAN auto entry via chip",
                    "07 - Auto-entry via contactless magnetic chip",
                    "79 - Chip card at chip-capable terminal was unable to process transaction using data on the chip or magnetic stripe on the card - therefore, PAN entry via manual entry",
                    "80 - Chip card at chip-capable terminal was unable to process transaction using data on the chip therefore the terminal defaulted to the magnetic stripe read for the PAN. This is referred to as fallback.",
                    "90 - Magnetic stripe read and full, unaltered contents provided",
                    "91 - Auto-entry via contactless magnetic strip"
                  ],
                  "description": "Indicates how the card's PAN was entered into the terminal at the time of the transaction"
                },
                "pinEntry": {
                  "type": "string",
                  "enum": [
                    "0 - Unspecified or Unknown  (default)",
                    "1 - Terminal has PIN entry capability",
                    "2 - Terminal does not have PIN entry capability",
                    "8 - Terminal has PIN entry capability but PIN pad is not currently operative."
                  ],
                  "description": "Indicates the terminal's PIN input capability at the time of the transaction"
                }
              },
              "description": "Indicates how the card was actually read by the terminal"
            },
            "onMerchantPremise": {
              "type": "boolean",
              "description": "Indicates whether or not the terminal is within the merchant's area of control"
            },
            "terminalAttended": {
              "type": "boolean",
              "description": "Indicates whether or not the merchant directly attends to the terminal"
            },
            "cardCaptureSupported": {
              "type": "boolean",
              "description": "Indicates whether or not the terminal has capabilities to capture (store) cards upon directive from the issuer"
            },
            "cardholderActivatedTerminal": {
              "type": "boolean",
              "description": "Indicates whether or not the cardholder activates and initiates transactions on the terminal directly instead of the merchant"
            },
            "type": {
              "type": "string",
              "description": "Indicates the type of terminal being used for the transaction",
              "enum": [
                "POS",
                "MPOS",
                "ATM",
                "IN_TRANSIT",
                "IN_FLIGHT"
              ]
            }
          },
          "description": "Information about the terminal used to read the contents of a card."
        }
      },
      "description": "Information about the merchant performing the request for the cardholder."
    },
    "payer": {
      "type": "object",
      "properties": {
        "fundingInstrument": {
          "type": "object",
          "properties": {
            "card": {
              "type": "object",
              "properties": {
                "cardNumber": {
                  "type": "string",
                  "description": "Personal Account Number (PAN) of the card used by the cardholder"
                },
                "expiryMonth": {
                  "type": "string",
                  "limit": "1..2",
                  "pattern": "0?[1-9]|1[0-2]",
                  "description": "Numeric format of the month (MM) when the card was set by the issuer to expire"
                },
                "expiryYear": {
                  "type": "string",
                  "limit": "4..4",
                  "pattern": "[\\d]{4}",
                  "description": "Numeric format of the year when (YYYY) the card was set by the issuer to expire"
                },
                "firstName": {
                  "type": "string",
                  "description": "First name of the cardholder"
                },
                "lastName": {
                  "type": "string",
                  "description": "Last name of the cardholder"
                },
                "cardPresentFields": {
                  "type": "object",
                  "properties": {
                    "cardSeqNum": {
                      "type": "string",
                      "limit": "3..3",
                      "pattern": "[0-9]{3}+",
                      "description": "Sequence number of the card read from the chip. Only present for EMV/chip-based transactions."
                    },
                    "emvIccData": {
                      "type": "string",
                      "limit": "1..340",
                      "description": "EMV ICC binary data read from the card, in Base64 encoding."
                    },
                    "track1": {
                      "type": "string",
                      "description": "Track 1 (magnetic stripe) data as read from the card. For chip cards, provided by \"Track 1 Equivalent Data\" read from the chip."
                    },
                    "track2": {
                      "type": "string",
                      "description": "Track 2 (magnetic stripe) data as read from the card. For chip cards, provided by \"Track 2 Equivalent Data\" read from the chip."
                    }
                  },
                  "description": "Details of the card read by a terminal (for card present transactions)"
                },
                "type": {
                  "type": "string",
                  "description": "(OPTIONAL) Indicates the type of the card used for the transaction",
                  "enum": [
                    "CREDIT",
                    "DEBIT"
                  ]
                },
                "account": {
                  "type": "string",
                  "description": "(OPTIONAL) Indicates the type of the account used for the transaction (default: DEFAULT)",
                  "enum": [
                    "DEFAULT",
                    "SAVINGS",
                    "CURRENT",
                    "CREDIT"
                  ]
                },
                "pin": {
                  "block": {
                    "type": "string",
                    "description": "PIN block encrypted under the PIN encryption key"
                  },
                  "format": {
                    "type": "string",
                    "description": "Format of the PIN block as generated by the terminal",
                    "enum": [
                      "ISO-0 - ISO 9564-1 & ANSI X9.8 format 0",
                      "ISO-1 - ISO 9564-1 format 1",
                      "ISO-3 - ISO 9564-1 & ANSI X9.8 format 3"
                    ]
                  },
                  "keyId": {
                    "type": "string",
                    "description": "Key ID of the encryption key used to encrypt the PIN block"
                  }
                }
              }
            }
          }
        }
      },
      "description": "Information about the cardholder where the source of funds for the transaction will come from."
    },
    "transaction": {
      "type": "object",
      "properties": {
        "initiator": {
          "type": "string",
          "enum": [
            "CONSUMER",
            "MERCHANT"
          ],
          "description": "(OPTIONAL) Identifies the initiator of the transaction. (default: CONSUMER)"
        },
        "intent": {
          "type": "string",
          "enum": [
            "PAYMENT",
            "VAULTING"
          ],
          "description": "(OPTIONAL) Identifies the intent of the transaction. (default: PAYMENT)"
        },
        "amount": {
          "type": "object",
          "properties": {
            "total": {
              "type": "object",
              "properties": {
                "currency": {
                  "type": "string"
                },
                "value": {
                  "type": "number"
                }
              }
            }
          }
        },
        "frequencyIndicator": {
          "type": "string",
          "enum": [
            "SINGLE - One-time transaction (default)",
            "RECURRING - Recurring transaction"
          ]
        },
        "description": {
          "type": "string",
          "limit": "0..512",
          "pattern": "[-a-zA-Z_0-9 .,]+"
        }
      },
      "description": "Information about the transaction being performed."
    },
    "trace": {
      "type": "object",
      "properties": {
        "batchNo": {
          "type": "string",
          "limit": "1..8",
          "pattern": "[A-Za-z0-9]{1,8}",
          "description": "(OPTIONAL, alphanum) batch of authorizations where the transaction is included"
        },
        "traceNo": {
          "type": "string",
          "limit": "1..6",
          "pattern": "[A-Za-z0-9]{1,6}",
          "description": "(OPTIONAL, alphanum) terminal-generated number for this transaction"
        }
      },
      "description": "(OPTIONAL) Values supplied by the transaction originator / terminal that can be used for reconciliation of transactions"
    }
  }
}

Content-Type: application/json

{
  "paymentTransactionReferenceNo": "02c8edb3-301a-4ce6-a8b2-cbcf37dbd5b5",
  "status": "SUCCESS",
  "createdAt": "2017-05-31T10:15:28.677Z",
  "receipt": {
    "transactionId": "01234567ABCD",
    "approvalCode": "000167",
    "batchNo": "20170601",
    "traceNo": "000001",
    "receiptNo": "805322262599"
  },
  "payer": {
    "fundingInstrument": {
      "card": {
        "cardNumber": "4761340000000043",
        "expiryMonth": "12",
        "expiryYear": "2022",
        "firstName": "SMART E MONEY",
        "lastName": "INC",
        "cardPresentFields": {
          "cardSeqNum": "001",
          "emvIccData": "ggIcAIQHoAAAAAMQEJUFgAAAAACaAxcEGZwBAF8qAgYInwIGAAAAAAEAnwMGAAAAAAAAnxASBgEKA6CAAAoCAAAAAABuefOZnxoCBgifHghQWU1ZUE9TMZ8mCA5/WLUnW3KxnycBgJ8zAyAgyJ80Ax4DAJ81ASGfNgIAyp83BKOXolWfQQQAAAAB",
          "track2": ";4834427000590355=19092010000000000914?2"
        }
      }
    }
  },
  "amount": {
    "total": {
      "currency": "PHP",
      "value": 10.5
    }
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "paymentTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number for the purchase request generated by P3. Merchants should keep track of this value for use in succeeding Void Purchase or Refund Purchase requests."
    },
    "status": {
      "type": "string",
      "description": "*DEPRECATED*. Indicates the result of the transaction. Merchants should no longer rely on this field for the actual transaction status, and should rely on the HTTP status code and the existence of a reference number as the indicator of a successful transaction."
    },
    "createdAt": {
      "type": "Calendar",
      "description": "Local time of the host when the transaction was processed."
    },
    "receipt": {
      "type": "object",
      "properties": {
        "transactionId": {
          "type": "string",
          "description": "Unique identifier returned by the issuer for this transaction."
        },
        "approvalCode": {
          "type": "string",
          "description": "Approval Code / Authorization Identification Code generated by the issuer to indicate the approval of a transaction"
        },
        "batchNo": {
          "type": "string",
          "description": "(alphanum, 8) Value supplied by P3, or the value of `transaction.trace.batchNo` during the request (if supplied), which indicates the batch of transactions that the specific transaction has been grouped with. Merchants may keep track of this value for reconnaissance."
        },
        "traceNo": {
          "type": "string",
          "description": "(alphanum, 8) Value of `transaction.trace.traceNo` during the request (if supplied)"
        },
        "receiptNo": {
          "type": "string",
          "description": "(alphanum, 12) A receipt / reference number generated by the acquirer. Can be used by all parties (cardholder, merchant, payment gateway, acquirer, issuer) when looking up a specific transaction record for reconnaisance."
        }
      },
      "description": "Additional transaction reference numbers generated by either the issuing bank or the acquiring host."
    },
    "payer": {
      "type": "object",
      "properties": {
        "fundingInstrument": {
          "type": "object",
          "properties": {
            "card": {
              "type": "object",
              "properties": {
                "cardNumber": {
                  "type": "string",
                  "description": "Personal Account Number (PAN) of the card used by the cardholder"
                },
                "expiryMonth": {
                  "type": "string",
                  "limit": "1..2",
                  "pattern": "0?[1-9]|1[0-2]",
                  "description": "Numeric format of the month (MM) when the card was set by the issuer to expire"
                },
                "expiryYear": {
                  "type": "string",
                  "limit": "4..4",
                  "pattern": "[\\d]{4}",
                  "description": "Numeric format of the year when (YYYY) the card was set by the issuer to expire"
                },
                "firstName": {
                  "type": "string",
                  "description": "First name of the cardholder"
                },
                "lastName": {
                  "type": "string",
                  "description": "Last name of the cardholder"
                }
              }
            }
          }
        }
      },
      "description": "information about the paying entity. Sensitive information (e.g., card number) may be masked."
    },
    "authorizationData": {
      "emvIccData": {
        "type": "string",
        "limit": "1..340",
        "description": "EMV ICC binary data returned by the Issuer. To be used for post-processing (e.g., Issuer Authentication by EMV EXTERNAL AUTHENTICATE or 2nd GENERATE AC)"
      }
    },
    "amount": {
      "type": "object",
      "properties": {
        "total": {
          "type": "object",
          "properties": {
            "currency": {
              "type": "string"
            },
            "value": {
              "type": "number"
            }
          }
        }
      },
      "description": "amount authorized for the transaction"
    }
  }
}

Content-Type: application/json
Request-Reference-No: A1D099C2-2479-4AAC-9F87-B2A304450REF
Authorization: Basic c2stYVhRZG9yT09GMHpHTWZ5VkF6VEg5Q2JBRnZxcTFPYzdQQVhjRGxyejV6eg==
X-Idempotency-Key: 1b85e8c8-771e-45a2-bb17-0eaae0e8a0ef
Latitude: 38.8897
Longitude: -77.0089

{
  "merchant": {
    "metadata": {
      "refNo": "ORDER-123954"
    }
  },
  "paymentTransactionReferenceNo": "02c8edb3-301a-4ce6-a8b2-cbcf37dbd5b5",
  "amount": {
    "currency": "PHP",
    "value": 10.5
  },
  "trace": {
    "batchNo": "000001",
    "traceNo": "000001"
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
      "merchant": {
          "type": "object",
          "properties": {
            "metadata": {
                "type": "object",
                "properties": {
                    "refNo": {
                        "type": "string",
                        "limit": "1..36",
                        "pattern": "*",
                        "description": "(OPTIONAL) Reference number of the merchant for the transaction."
                    }
                },
                "description": "(OPTIONAL) Transaction-specific metadata for the merchant involved"
            },
        },
        "description": "Information about the merchant performing the request for the cardholder."
      },
    "paymentTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number generated by P3 from a previous successful Authorization request."
    },
    "amount": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        },
        "value": {
          "type": "number"
        }
      },
      "description": "Amount from the previous authorization transaction being captured."
    },
    "trace": {
      "type": "object",
      "properties": {
        "batchNo": {
          "type": "string",
          "limit": "1..8",
          "pattern": "[A-Za-z0-9]{1,8}",
          "description": "(OPTIONAL, alphanum) batch of authorizations where the transaction is included"
        },
        "traceNo": {
          "type": "string",
          "limit": "1..6",
          "pattern": "[A-Za-z0-9]{1,6}",
          "description": "(OPTIONAL, alphanum) terminal-generated number for this transaction"
        }
      },
      "description": "(OPTIONAL) Values supplied by the transaction originator / terminal that can be used for reconciliation of transactions"
    }
  }
}

Content-Type: application/json

{
  "paymentTransactionReferenceNo": "02c8edb3-301a-4ce6-a8b2-cbcf37dbd5b5",
  "status": "SUCCESS",
  "createdAt": "2017-05-31T10:15:28.677Z",
  "receipt": {
    "transactionId": "01234567ABCD",
    "approvalCode": "000167",
    "batchNo": "20170601",
    "traceNo": "000001",
    "receiptNo": "805322262599"
  },
  "captureTransactionReferenceNo": "69b5e571-7d44-4409-9359-ff93555a65a3",
  "authorisedAmount": {
    "currency": "PHP",
    "value": 10.5
  },
  "capturedAmount": {
    "currency": "PHP",
    "value": 10.5
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "paymentTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number for the purchase request generated by P3. Merchants should keep track of this value for use in succeeding Void Purchase or Refund Purchase requests."
    },
    "status": {
      "type": "string",
      "description": "*DEPRECATED*. Indicates the result of the transaction. Merchants should no longer rely on this field for the actual transaction status, and should rely on the HTTP status code and the existence of a reference number as the indicator of a successful transaction."
    },
    "createdAt": {
      "type": "Calendar",
      "description": "Local time of the host when the transaction was processed."
    },
    "receipt": {
      "type": "object",
      "properties": {
        "transactionId": {
          "type": "string",
          "description": "Unique identifier returned by the issuer for this transaction."
        },
        "approvalCode": {
          "type": "string",
          "description": "Approval Code / Authorization Identification Code generated by the issuer to indicate the approval of a transaction"
        },
        "batchNo": {
          "type": "string",
          "description": "(alphanum, 8) Value supplied by P3, or the value of `transaction.trace.batchNo` during the request (if supplied), which indicates the batch of transactions that the specific transaction has been grouped with. Merchants may keep track of this value for reconnaissance."
        },
        "traceNo": {
          "type": "string",
          "description": "(alphanum, 8) Value of `transaction.trace.traceNo` during the request (if supplied)"
        },
        "receiptNo": {
          "type": "string",
          "description": "(alphanum, 12) A receipt / reference number generated by the acquirer. Can be used by all parties (cardholder, merchant, payment gateway, acquirer, issuer) when looking up a specific transaction record for reconnaisance."
        }
      },
      "description": "Additional transaction reference numbers generated by either the issuing bank or the acquiring host."
    },
    "captureTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number for the capture request generated by P3."
    },
    "authorisedAmount": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        },
        "value": {
          "type": "number"
        }
      },
      "description": "Total amount authorized for the specified authorization transaction."
    },
    "capturedAmount": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        },
        "value": {
          "type": "number"
        }
      },
      "description": "Total amount already captured for the specified authorization transaction. This already includes amounts previously captured for the specified authorization transaction."
    }
  }
}

Content-Type: application/json
Request-Reference-No: A1D099C2-2479-4AAC-9F87-B2A304450REF
Authorization: Basic c2stYVhRZG9yT09GMHpHTWZ5VkF6VEg5Q2JBRnZxcTFPYzdQQVhjRGxyejV6eg==
X-Idempotency-Key: 1b85e8c8-771e-45a2-bb17-0eaae0e8a0ef
Latitude: 38.8897
Longitude: -77.0089

{
  "merchant": {
    "metadata": {
      "refNo": "ORDER-123954"
    }
  },
  "paymentTransactionReferenceNo": "02c8edb3-301a-4ce6-a8b2-cbcf37dbd5b5",
  "amount": {
    "currency": "PHP",
    "value": 10.5
  },
  "trace": {
    "batchNo": "000001",
    "traceNo": "000001"
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
      "merchant": {
          "type": "object",
          "properties": {
            "metadata": {
                "type": "object",
                "properties": {
                    "refNo": {
                        "type": "string",
                        "limit": "1..36",
                        "pattern": "*",
                        "description": "(OPTIONAL) Reference number of the merchant for the transaction."
                    }
                },
                "description": "(OPTIONAL) Transaction-specific metadata for the merchant involved"
            },
        },
        "description": "Information about the merchant performing the request for the cardholder."
      },
    "paymentTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number generated by P3 from a previous successful Authorization request."
    },
    "amount": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        },
        "value": {
          "type": "number"
        }
      },
      "description": "Amount from the previous authorization transaction being captured."
    },
    "trace": {
      "type": "object",
      "properties": {
        "batchNo": {
          "type": "string",
          "limit": "1..8",
          "pattern": "[A-Za-z0-9]{1,8}",
          "description": "(OPTIONAL, alphanum) batch of authorizations where the transaction is included"
        },
        "traceNo": {
          "type": "string",
          "limit": "1..6",
          "pattern": "[A-Za-z0-9]{1,6}",
          "description": "(OPTIONAL, alphanum) terminal-generated number for this transaction"
        }
      },
      "description": "(OPTIONAL) Values supplied by the transaction originator / terminal that can be used for reconciliation of transactions"
    }
  }
}

Content-Type: application/json

{
  "paymentTransactionReferenceNo": "02c8edb3-301a-4ce6-a8b2-cbcf37dbd5b5",
  "status": "SUCCESS",
  "createdAt": "2017-05-31T10:15:28.677Z",
  "receipt": {
    "transactionId": "01234567ABCD",
    "approvalCode": "000167",
    "batchNo": "20170601",
    "traceNo": "000001",
    "receiptNo": "805322262599"
  },
  "captureTransactionReferenceNo": "69b5e571-7d44-4409-9359-ff93555a65a3",
  "authorisedAmount": {
    "currency": "PHP",
    "value": 10.5
  },
  "capturedAmount": {
    "currency": "PHP",
    "value": 10.5
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "paymentTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number for the purchase request generated by P3. Merchants should keep track of this value for use in succeeding Void Purchase or Refund Purchase requests."
    },
    "status": {
      "type": "string",
      "description": "*DEPRECATED*. Indicates the result of the transaction. Merchants should no longer rely on this field for the actual transaction status, and should rely on the HTTP status code and the existence of a reference number as the indicator of a successful transaction."
    },
    "createdAt": {
      "type": "Calendar",
      "description": "Local time of the host when the transaction was processed."
    },
    "receipt": {
      "type": "object",
      "properties": {
        "transactionId": {
          "type": "string",
          "description": "Unique identifier returned by the issuer for this transaction."
        },
        "approvalCode": {
          "type": "string",
          "description": "Approval Code / Authorization Identification Code generated by the issuer to indicate the approval of a transaction"
        },
        "batchNo": {
          "type": "string",
          "description": "(alphanum, 8) Value supplied by P3, or the value of `transaction.trace.batchNo` during the request (if supplied), which indicates the batch of transactions that the specific transaction has been grouped with. Merchants may keep track of this value for reconnaissance."
        },
        "traceNo": {
          "type": "string",
          "description": "(alphanum, 8) Value of `transaction.trace.traceNo` during the request (if supplied)"
        },
        "receiptNo": {
          "type": "string",
          "description": "(alphanum, 12) A receipt / reference number generated by the acquirer. Can be used by all parties (cardholder, merchant, payment gateway, acquirer, issuer) when looking up a specific transaction record for reconnaisance."
        }
      },
      "description": "Additional transaction reference numbers generated by either the issuing bank or the acquiring host."
    },
    "captureTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number for the capture request generated by P3."
    },
    "authorisedAmount": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        },
        "value": {
          "type": "number"
        }
      },
      "description": "Total amount authorized for the specified authorization transaction."
    },
    "capturedAmount": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        },
        "value": {
          "type": "number"
        }
      },
      "description": "Total amount already captured for the specified authorization transaction. This already includes amounts previously captured for the specified authorization transaction."
    }
  }
}

Content-Type: application/json
Request-Reference-No: A1D099C2-2479-4AAC-9F87-B2A30445VOID
Authorization: Basic c2stYVhRZG9yT09GMHpHTWZ5VkF6VEg5Q2JBRnZxcTFPYzdQQVhjRGxyejV6eg==
X-Idempotency-Key: b0ce695f-1e2d-4a2e-9c8e-47c91c93bc3d
Latitude: 38.8897
Longitude: -77.0089

{
  "metadata": {
    "refNo": "ORDER-123954"
  },
  "paymentTransactionReferenceNo": "02c8edb3-301a-4ce6-a8b2-cbcf37dbd5b5",
  "reason": "Requested by Customer",
  "reasonCode": "00",
  "trace": {
    "batchNo": "000001",
    "traceNo": "000001"
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "merchant": {
        "type": "object",
        "properties": {
          "metadata": {
              "type": "object",
              "properties": {
                  "refNo": {
                      "type": "string",
                      "limit": "1..36",
                      "pattern": "*",
                      "description": "(OPTIONAL) Reference number of the merchant for the transaction."
                  }
              },
              "description": "(OPTIONAL) Transaction-specific metadata for the merchant involved"
          },
      },
      "description": "Information about the merchant performing the request for the cardholder."
    },
    "paymentTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number generated by P3 from a previous successful Purchase request."
    },
    "reason": {
      "type": "string",
      "limit": "0..512",
      "pattern": "[-a-zA-Z_0-9 .,]+",
      "description": "Short description of the reason why the purchase transaction is being voided."
    },
    "reasonCode": {
      "type": "string",
      "enum": [
        "00 - Transaction voided upon request from the cardholder / customer",
        "01 - Transaction cannot be completed by the merchant (e.g., goods and services are no longer available after the purchase request has been approved)",
        "02 - Transaction voided due to an error encountered by the terminal and/or merchant application/system (e.g., in case of chip card processing, Issuer Authentication Data was rejected by the card)",
        "03 - Transaction voided due to communication failure or system timeout",
        "04 - Transaction voided due to card being pulled out from terminal before transaction completion"
      ],
      "description": "Indicates the general category why the void / reversal operation is being performed."
    },
    "trace": {
      "type": "object",
      "properties": {
        "batchNo": {
          "type": "string",
          "limit": "1..8",
          "pattern": "[A-Za-z0-9]{1,8}",
          "description": "(OPTIONAL, alphanum) batch of authorizations where the transaction is included"
        },
        "traceNo": {
          "type": "string",
          "limit": "1..6",
          "pattern": "[A-Za-z0-9]{1,6}",
          "description": "(OPTIONAL, alphanum) terminal-generated number for this transaction"
        }
      },
      "description": "(OPTIONAL) Values supplied by the transaction originator / terminal that can be used for reconciliation of transactions"
    }
  }
}

Content-Type: application/json

{
  "paymentTransactionReferenceNo": "02c8edb3-301a-4ce6-a8b2-cbcf37dbd5b5",
  "status": "SUCCESS",
  "createdAt": "2017-05-31T10:15:28.677Z",
  "receipt": {
    "transactionId": "01234567ABCD",
    "approvalCode": "000167",
    "batchNo": "20170601",
    "traceNo": "000001",
    "receiptNo": "805322262599"
  },
  "voidTransactionReferenceNo": "69b5e571-7d44-4409-9359-ff93555a65a3",
  "transactionAmount": {
    "currency": "PHP",
    "value": 10.5
  },
  "voidedAmount": {
    "currency": "PHP",
    "value": 10.5
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "paymentTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number for the purchase request generated by P3. Merchants should keep track of this value for use in succeeding Void Purchase or Refund Purchase requests."
    },
    "status": {
      "type": "string",
      "description": "*DEPRECATED*. Indicates the result of the transaction. Merchants should no longer rely on this field for the actual transaction status, and should rely on the HTTP status code and the existence of a reference number as the indicator of a successful transaction."
    },
    "createdAt": {
      "type": "string",
      "description": "Local time of the host when the transaction was processed."
    },
    "receipt": {
      "type": "object",
      "properties": {
        "transactionId": {
          "type": "string",
          "description": "Unique identifier returned by the issuer for this transaction."
        },
        "approvalCode": {
          "type": "string",
          "description": "Approval Code / Authorization Identification Code generated by the issuer to indicate the approval of a transaction"
        },
        "batchNo": {
          "type": "string",
          "description": "(alphanum, 8) Value supplied by P3, or the value of `transaction.trace.batchNo` during the request (if supplied), which indicates the batch of transactions that the specific transaction has been grouped with. Merchants may keep track of this value for reconnaissance."
        },
        "traceNo": {
          "type": "string",
          "description": "(alphanum, 8) Value of `transaction.trace.traceNo` during the request (if supplied)"
        },
        "receiptNo": {
          "type": "string",
          "description": "(alphanum, 12) A receipt / reference number generated by the acquirer. Can be used by all parties (cardholder, merchant, payment gateway, acquirer, issuer) when looking up a specific transaction record for reconnaisance."
        }
      },
      "description": "Additional transaction reference numbers generated by either the issuing bank or the acquiring host."
    },
    "voidTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number for the void request generated by P3."
    },
    "transactionAmount": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        },
        "value": {
          "type": "number"
        }
      },
      "description": "Amount of the transaction being voided."
    },
    "voidedAmount": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        },
        "value": {
          "type": "number"
        }
      },
      "description": "Actual amount voided for this transaction."
    }
  }
}

Content-Type: application/json
Request-Reference-No: A1D099C2-2479-4AAC-9F87-B2A30445VOID
Authorization: Basic c2stYVhRZG9yT09GMHpHTWZ5VkF6VEg5Q2JBRnZxcTFPYzdQQVhjRGxyejV6eg==
X-Idempotency-Key: bcd39fb5-eaaa-4265-9ddf-7836e58c6862
Latitude: 38.8897
Longitude: -77.0089

{
  "metadata": {
    "refNo": "ORDER-123954"
  },
  "paymentRequestReferenceNo": "A1D099C2-2479-4AAC-9F87-B2A304450PAY",
  "merchantId": "EFS100001149",
  "amount": {
    "currency": "PHP",
    "value": 10.5
  },
  "reason": "Reversal due to system timeout",
  "reasonCode": "00",
  "trace": {
    "batchNo": "000001",
    "traceNo": "000001"
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "merchant": {
        "type": "object",
        "properties": {
          "metadata": {
              "type": "object",
              "properties": {
                  "refNo": {
                      "type": "string",
                      "limit": "1..36",
                      "pattern": "*",
                      "description": "(OPTIONAL) Reference number of the merchant for the transaction."
                  }
              },
              "description": "(OPTIONAL) Transaction-specific metadata for the merchant involved"
          },
      },
      "description": "Information about the merchant performing the request for the cardholder."
    },
    "paymentRequestReferenceNo": {
      "type": "string",
      "description": "Reference number (from header `Request-Reference-No`) provided by the merchant in the previous purchase request being voided."
    },
    "merchantId": {
      "type": "string",
      "description": "Unique ID issued by PayMaya to the merchant."
    },
    "amount": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        },
        "value": {
          "type": "number"
        }
      },
      "description": "Amount of the previous purchase transaction being voided."
    },
    "reason": {
      "type": "string",
      "limit": "0..512",
      "pattern": "[-a-zA-Z_0-9 .,]+",
      "description": "Short description of the reason why the purchase transaction is being voided."
    },
    "reasonCode": {
      "type": "string",
      "enum": [
        "00 - Transaction voided upon request from the cardholder / customer",
        "01 - Transaction cannot be completed by the merchant (e.g., goods and services are no longer available after the purchase request has been approved)",
        "02 - Transaction voided due to an error encountered by the terminal and/or merchant application/system (e.g., in case of chip card processing, Issuer Authentication Data was rejected by the card)",
        "03 - Transaction voided due to communication failure or system timeout",
        "04 - Transaction voided due to card being pulled out from terminal before transaction completion"
      ],
      "description": "Indicates the general category why the void / reversal operation is being performed."
    },
    "trace": {
      "type": "object",
      "properties": {
        "batchNo": {
          "type": "string",
          "limit": "1..8",
          "pattern": "[A-Za-z0-9]{1,8}",
          "description": "(OPTIONAL, alphanum) batch of authorizations where the transaction is included"
        },
        "traceNo": {
          "type": "string",
          "limit": "1..6",
          "pattern": "[A-Za-z0-9]{1,6}",
          "description": "(OPTIONAL, alphanum) terminal-generated number for this transaction"
        }
      },
      "description": "(OPTIONAL) Values supplied by the transaction originator / terminal that can be used for reconciliation of transactions"
    }
  }
}

Content-Type: application/json

{
  "paymentTransactionReferenceNo": "02c8edb3-301a-4ce6-a8b2-cbcf37dbd5b5",
  "status": "SUCCESS",
  "createdAt": "2017-05-31T10:15:28.677Z",
  "receipt": {
    "transactionId": "01234567ABCD",
    "approvalCode": "000167",
    "batchNo": "20170601",
    "traceNo": "000001",
    "receiptNo": "805322262599"
  },
  "voidTransactionReferenceNo": "69b5e571-7d44-4409-9359-ff93555a65a3",
  "transactionAmount": {
    "currency": "PHP",
    "value": 10.5
  },
  "voidedAmount": {
    "currency": "PHP",
    "value": 10.5
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "paymentTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number for the purchase request generated by P3. Merchants should keep track of this value for use in succeeding Void Purchase or Refund Purchase requests."
    },
    "status": {
      "type": "string",
      "description": "*DEPRECATED*. Indicates the result of the transaction. Merchants should no longer rely on this field for the actual transaction status, and should rely on the HTTP status code and the existence of a reference number as the indicator of a successful transaction."
    },
    "createdAt": {
      "type": "string",
      "description": "Local time of the host when the transaction was processed."
    },
    "receipt": {
      "type": "object",
      "properties": {
        "transactionId": {
          "type": "string",
          "description": "Unique identifier returned by the issuer for this transaction."
        },
        "approvalCode": {
          "type": "string",
          "description": "Approval Code / Authorization Identification Code generated by the issuer to indicate the approval of a transaction"
        },
        "batchNo": {
          "type": "string",
          "description": "(alphanum, 8) Value supplied by P3, or the value of `transaction.trace.batchNo` during the request (if supplied), which indicates the batch of transactions that the specific transaction has been grouped with. Merchants may keep track of this value for reconnaissance."
        },
        "traceNo": {
          "type": "string",
          "description": "(alphanum, 8) Value of `transaction.trace.traceNo` during the request (if supplied)"
        },
        "receiptNo": {
          "type": "string",
          "description": "(alphanum, 12) A receipt / reference number generated by the acquirer. Can be used by all parties (cardholder, merchant, payment gateway, acquirer, issuer) when looking up a specific transaction record for reconnaisance."
        }
      },
      "description": "Additional transaction reference numbers generated by either the issuing bank or the acquiring host."
    },
    "voidTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number for the void request generated by P3."
    },
    "transactionAmount": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        },
        "value": {
          "type": "number"
        }
      },
      "description": "Amount of the transaction being voided."
    },
    "voidedAmount": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        },
        "value": {
          "type": "number"
        }
      },
      "description": "Actual amount voided for this transaction."
    }
  }
}

Content-Type: application/json
Request-Reference-No: A1D099C2-2479-4AAC-9F87-B2A304450REF
Authorization: Basic c2stYVhRZG9yT09GMHpHTWZ5VkF6VEg5Q2JBRnZxcTFPYzdQQVhjRGxyejV6eg==
X-Idempotency-Key: f0614cfd-90ee-43ab-8248-15cae51f4f2b
Latitude: 38.8897
Longitude: -77.0089

{
  "metadata": {
    "refNo": "ORDER-123954"
  },
  "paymentTransactionReferenceNo": "02c8edb3-301a-4ce6-a8b2-cbcf37dbd5b5",
  "amount": {
    "currency": "PHP",
    "value": 10.5
  },
  "reason": "Purchased item is defective",
  "trace": {
    "batchNo": "000001",
    "traceNo": "000001"
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
      "merchant": {
          "type": "object",
          "properties": {
            "metadata": {
                "type": "object",
                "properties": {
                    "refNo": {
                        "type": "string",
                        "limit": "1..36",
                        "pattern": "*",
                        "description": "(OPTIONAL) Reference number of the merchant for the transaction."
                    }
                },
                "description": "(OPTIONAL) Transaction-specific metadata for the merchant involved"
            },
        },
        "description": "Information about the merchant performing the request for the cardholder."
      },
    "paymentTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number generated by P3 from a previous successful Purchase request."
    },
    "amount": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        },
        "value": {
          "type": "number"
        }
      },
      "description": "Amount from the previous purchase transaction being refunded."
    },
    "reason": {
      "type": "string",
      "limit": "0..512",
      "pattern": "[-a-zA-Z_0-9 .,]+",
      "description": "Short description of the reason why the purchase transaction is being refunded."
    },
    "trace": {
      "type": "object",
      "properties": {
        "batchNo": {
          "type": "string",
          "limit": "1..8",
          "pattern": "[A-Za-z0-9]{1,8}",
          "description": "(OPTIONAL, alphanum) batch of authorizations where the transaction is included"
        },
        "traceNo": {
          "type": "string",
          "limit": "1..6",
          "pattern": "[A-Za-z0-9]{1,6}",
          "description": "(OPTIONAL, alphanum) terminal-generated number for this transaction"
        }
      },
      "description": "(OPTIONAL) Values supplied by the transaction originator / terminal that can be used for reconciliation of transactions"
    }
  }
}

Content-Type: application/json

{
  "paymentTransactionReferenceNo": "02c8edb3-301a-4ce6-a8b2-cbcf37dbd5b5",
  "status": "SUCCESS",
  "createdAt": "2017-05-31T10:15:28.677Z",
  "receipt": {
    "transactionId": "01234567ABCD",
    "approvalCode": "000167",
    "batchNo": "20170601",
    "traceNo": "000001",
    "receiptNo": "805322262599"
  },
  "refundTransactionReferenceNo": "69b5e571-7d44-4409-9359-ff93555a65a3",
  "transactionAmount": {
    "currency": "PHP",
    "value": 10.5
  },
  "refundedAmount": {
    "currency": "PHP",
    "value": 10.5
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "paymentTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number for the purchase request generated by P3. Merchants should keep track of this value for use in succeeding Void Purchase or Refund Purchase requests."
    },
    "status": {
      "type": "string",
      "description": "*DEPRECATED*. Indicates the result of the transaction. Merchants should no longer rely on this field for the actual transaction status, and should rely on the HTTP status code and the existence of a reference number as the indicator of a successful transaction."
    },
    "createdAt": {
      "type": "string",
      "description": "Local time of the host when the transaction was processed."
    },
    "receipt": {
      "type": "object",
      "properties": {
        "transactionId": {
          "type": "string",
          "description": "Unique identifier returned by the issuer for this transaction."
        },
        "approvalCode": {
          "type": "string",
          "description": "Approval Code / Authorization Identification Code generated by the issuer to indicate the approval of a transaction"
        },
        "batchNo": {
          "type": "string",
          "description": "(alphanum, 8) Value supplied by P3, or the value of `transaction.trace.batchNo` during the request (if supplied), which indicates the batch of transactions that the specific transaction has been grouped with. Merchants may keep track of this value for reconnaissance."
        },
        "traceNo": {
          "type": "string",
          "description": "(alphanum, 8) Value of `transaction.trace.traceNo` during the request (if supplied)"
        },
        "receiptNo": {
          "type": "string",
          "description": "(alphanum, 12) A receipt / reference number generated by the acquirer. Can be used by all parties (cardholder, merchant, payment gateway, acquirer, issuer) when looking up a specific transaction record for reconnaisance."
        }
      },
      "description": "Additional transaction reference numbers generated by either the issuing bank or the acquiring host."
    },
    "refundTransactionReferenceNo": {
      "type": "string",
      "description": "Unique reference number for the refund request generated by P3."
    },
    "transactionAmount": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        },
        "value": {
          "type": "number"
        }
      },
      "description": "Amount requested to be refunded."
    },
    "refundedAmount": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string"
        },
        "value": {
          "type": "number"
        }
      },
      "description": "Total amount already refunded for the specified purchase transaction. This already includes amounts previously refunded for the specified purchase transaction."
    }
  }
}

Content-Type: application/json
Request-Reference-No: A1D099C2-2479-4AAC-9F87-B2A304450BBB
Authorization: Basic c2stYVhRZG9yT09GMHpHTWZ5VkF6VEg5Q2JBRnZxcTFPYzdQQVhjRGxyejV6eg==

{
  "payer": {
    "fundingInstrument": {
      "card": {
        "cardNumber": "4761340000000043",
        "expiryMonth": "12",
        "expiryYear": "2022",
        "firstName": "SMART E MONEY",
        "lastName": "INC",
        "cardPresentFields": {
          "cardSeqNum": "001",
          "emvIccData": "ggIcAIQHoAAAAAMQEJUFgAAAAACaAxcEGZwBAF8qAgYInwIGAAAAAAEAnwMGAAAAAAAAnxASBgEKA6CAAAoCAAAAAABuefOZnxoCBgifHghQWU1ZUE9TMZ8mCA5/WLUnW3KxnycBgJ8zAyAgyJ80Ax4DAJ81ASGfNgIAyp83BKOXolWfQQQAAAAB",
          "track2": ";4834427000590355=19092010000000000914?2"
        },
        "type": "CREDIT",
        "account": "DEFAULT",
        "pin": {
          "block": "B0726345EBF1DEB9",
          "format": "ISO-0",
          "keyId": "F33900F3-7115-4F1F-ADD2-B5D02E9721E9"
        }
      }
    }
  },
  "merchant": {
    "id": "EFS100001149",
    "metadata": {
      "refNo": "ORDER-123954"
    },
    "acquiringTerminal": {
      "id": "PYMYPOS1",
      "inputCapability": {
        "magstripeReader": true,
        "emvChip": true
      },
      "posEntryMode": {
        "panEntry": "05",
        "pinEntry": "2"
      },
      "onMerchantPremise": true,
      "terminalAttended": true,
      "cardCaptureSupported": false,
      "cardholderActivatedTerminal": true
    }
  },
  "trace": {
    "batchNo": "000001",
    "traceNo": "000001"
  }
}

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "merchant": {
      "type": "object",
      "properties": {
        "metadata": {
          "type": "object",
          "properties": {
            "refNo": {
              "type": "string",
              "limit": "1..36",
              "pattern": "*",
              "description": "(OPTIONAL) Reference number of the merchant for the transaction."
            }
          },
          "description": "(OPTIONAL) Transaction-specific metadata for the merchant involved"
        },
        "id": {
          "type": "string",
          "description": "Unique ID issued by PayMaya to the merchant."
        },
        "acquiringTerminal": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "limit": "1..36",
              "pattern": "[-a-zA-Z_0-9]+",
              "description": "Unique ID of the terminal."
            },
            "inputCapability": {
              "type": "object",
              "properties": {
                "keyEntry": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal has a keypad (physical or electronic) to accept manual input of card data (default: false)"
                },
                "magstripeReader": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal supports reading of contact magnetic stripe cards (swipe) (default: false)"
                },
                "emvChip": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal supports reading of contact chip cards (dip) (default: false)"
                },
                "contactless": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal supports reading of contactless chip cards (tap) (default: false)"
                },
                "contactlessMagstripe": {
                  "type": "boolean",
                  "description": "Indicates whether or not the terminal supports reading of contactless magnetic stripe chip cards (tap) (default: false)"
                }
              },
              "description": "Indicates the capabilities of the terminal that read the card"
            },
            "posEntryMode": {
              "type": "object",
              "properties": {
                "panEntry": {
                  "type": "string",
                  "enum": [
                    "00 - PAN Entry Mode is unknown (default)",
                    "01 - Manual Entry",
                    "02 - Magnetic stripe read, but full unaltered contents not provided",
                    "05 - PAN auto entry via chip",
                    "07 - Auto-entry via contactless magnetic chip",
                    "79 - Chip card at chip-capable terminal was unable to process transaction using data on the chip or magnetic stripe on the card - therefore, PAN entry via manual entry",
                    "80 - Chip card at chip-capable terminal was unable to process transaction using data on the chip therefore the terminal defaulted to the magnetic stripe read for the PAN. This is referred to as fallback.",
                    "90 - Magnetic stripe read and full, unaltered contents provided",
                    "91 - Auto-entry via contactless magnetic strip"
                  ],
                  "description": "Indicates how the card's PAN was entered into the terminal at the time of the transaction"
                },
                "pinEntry": {
                  "type": "string",
                  "enum": [
                    "0 - Unspecified or Unknown  (default)",
                    "1 - Terminal has PIN entry capability",
                    "2 - Terminal does not have PIN entry capability",
                    "8 - Terminal has PIN entry capability but PIN pad is not currently operative."
                  ],
                  "description": "Indicates the terminal's PIN input capability at the time of the transaction"
                }
              },
              "description": "Indicates how the card was actually read by the terminal"
            },
            "onMerchantPremise": {
              "type": "boolean",
              "description": "Indicates whether or not the terminal is within the merchant's area of control"
            },
            "terminalAttended": {
              "type": "boolean",
              "description": "Indicates whether or not the merchant directly attends to the terminal"
            },
            "cardCaptureSupported": {
              "type": "boolean",
              "description": "Indicates whether or not the terminal has capabilities to capture (store) cards upon directive from the issuer"
            },
            "cardholderActivatedTerminal": {
              "type": "boolean",
              "description": "Indicates whether or not the cardholder activates and initiates transactions on the terminal directly instead of the merchant"
            },
            "type": {
              "type": "string",
              "description": "Indicates the type of terminal being used for the transaction",
              "enum": [
                "POS",
                "MPOS",
                "ATM",
                "IN_TRANSIT",
                "IN_FLIGHT"
              ]
            }
          },
          "description": "Information about the terminal used to read the contents of a card."
        }
      },
      "description": "Information about the merchant performing the request for the cardholder."
    },
    "payer": {
      "type": "object",
      "properties": {
        "fundingInstrument": {
          "type": "object",
          "properties": {
            "card": {
              "type": "object",
              "properties": {
                "cardNumber": {
                  "type": "string",
                  "description": "Personal Account Number (PAN) of the card used by the cardholder"
                },
                "expiryMonth": {
                  "type": "string",
                  "limit": "1..2",
                  "pattern": "0?[1-9]|1[0-2]",
                  "description": "Numeric format of the month (MM) when the card was set by the issuer to expire"
                },
                "expiryYear": {
                  "type": "string",
                  "limit": "4..4",
                  "pattern": "[\\d]{4}",
                  "description": "Numeric format of the year when (YYYY) the card was set by the issuer to expire"
                },
                "firstName": {
                  "type": "string",
                  "description": "First name of the cardholder"
                },
                "lastName": {
                  "type": "string",
                  "description": "Last name of the cardholder"
                },
                "cardPresentFields": {
                  "type": "object",
                  "properties": {
                    "cardSeqNum": {
                      "type": "string",
                      "limit": "3..3",
                      "pattern": "[0-9]{3}+",
                      "description": "Sequence number of the card read from the chip. Only present for EMV/chip-based transactions."
                    },
                    "emvIccData": {
                      "type": "string",
                      "limit": "1..340",
                      "description": "EMV ICC binary data read from the card, in Base64 encoding."
                    },
                    "track1": {
                      "type": "string",
                      "description": "Track 1 (magnetic stripe) data as read from the card. For chip cards, provided by \"Track 1 Equivalent Data\" read from the chip."
                    },
                    "track2": {
                      "type": "string",
                      "description": "Track 2 (magnetic stripe) data as read from the card. For chip cards, provided by \"Track 2 Equivalent Data\" read from the chip."
                    }
                  },
                  "description": "Details of the card read by a terminal (for card present transactions)"
                },
                "type": {
                  "type": "string",
                  "description": "(OPTIONAL) Indicates the type of the card used for the transaction",
                  "enum": [
                    "CREDIT",
                    "DEBIT"
                  ]
                },
                "account": {
                  "type": "string",
                  "description": "(OPTIONAL) Indicates the type of the account used for the transaction (default: DEFAULT)",
                  "enum": [
                    "DEFAULT",
                    "SAVINGS",
                    "CURRENT",
                    "CREDIT"
                  ]
                },
                "pin": {
                  "block": {
                    "type": "string",
                    "description": "PIN block encrypted under the PIN encryption key"
                  },
                  "format": {
                    "type": "string",
                    "description": "Format of the PIN block as generated by the terminal",
                    "enum": [
                      "ISO-0 - ISO 9564-1 & ANSI X9.8 format 0",
                      "ISO-1 - ISO 9564-1 format 1",
                      "ISO-3 - ISO 9564-1 & ANSI X9.8 format 3"
                    ]
                  },
                  "keyId": {
                    "type": "string",
                    "description": "Key ID of the encryption key used to encrypt the PIN block"
                  }
                }
              }
            }
          }
        }
      },
      "description": "Information about the cardholder where the source of funds for the transaction will come from."
    },
    "trace": {
      "type": "object",
      "properties": {
        "batchNo": {
          "type": "string",
          "limit": "1..8",
          "pattern": "[A-Za-z0-9]{1,8}",
          "description": "(OPTIONAL, alphanum) batch of authorizations where the transaction is included"
        },
        "traceNo": {
          "type": "string",
          "limit": "1..6",
          "pattern": "[A-Za-z0-9]{1,6}",
          "description": "(OPTIONAL, alphanum) terminal-generated number for this transaction"
        }
      },
      "description": "(OPTIONAL) Values supplied by the transaction originator / terminal that can be used for reconciliation of transactions"
    }
  }
}