Create a purchase with fraud screening

Changed on
post/purchases

Request

  • Base URL
    https://gateway.pmnts-sandbox.io/v1.0
  • URL
    https://gateway.pmnts-sandbox.io/v1.0/purchases
  • Auth
    HTTP basic

Headers

Content-Typestring

application/json

Request body

amountinteger required

A positive integer representing how much to charge, in the smallest currency unit (eg., 100 to charge $1.00, or 100 to Charge ¥100, a zero decimal currency)

referencestring required

Reference of the transaction. Max length 255 characters.

customer_ipstring required

RFC791 or RFC8200 compliant IP address

currencystring required

Three letter ISO currency code, in UPPERCASE

card_numberstring required

Card number

card_holderstring required

Name of the card holder

card_expirystring required

Format: MM/YYYY

card_tokenstring
cvvstring

CVV card number. (3/4 characters)

metadataobject
addendum_datastring

Response

200

successfulboolean
testboolean

Example response

{
  "successful": true,
  "response": {
    "authorization": "0",
    "id": "071-P-RHN5DC15",
    "card_number": "512345XXXXXX2346",
    "card_holder": "Jim Smith",
    "card_expiry": "2023-05-31",
    "card_token": "pfjeiyx4fk0uko3ev4kd",
    "card_type": "MasterCard",
    "card_category": "Credit",
    "card_subcategory": "Standard",
    "amount": 1000,
    "decimal_amount": 10,
    "message": "Declined.",
    "reference": "Ud5CfaAlwTKJi2kfsAesdAwvIk2fpJjP",
    "currency": "USD",
    "transaction_id": "071-P-RHN5DC15",
    "transaction_date": "2018-10-09T14:01:06+11:00",
    "response_code": "01",
    "rrn": "0",
    "cvv_match": "U",
    "fraud_result": "Deny",
    "fraud_messages": [
      "An attribute associated with an Order matched a pre-configured 'Always Deny' rule."
    ]
  },
  "test": true
}

Changes