payment
Description
The historical record of payment applied to a given transaction which includes the payment gateway response, purchase order, third party id and/or masked payment card information.
Interact with this resource
To interact with this resource and see it in the context of the API, you can utilise Postman or your Terminal/Console to perform requests. If you have a Foxy store, you can also use the API browser in the admin to interact with resources connected to your store.
Actions
- GET
- View a payment
- HEAD
- Get just the header response
- OPTIONS
- Get a response explaining which HTTP methods are supported
Properties
Property | Description | Type | Constraints |
---|---|---|---|
type | The payment type for this payment. Values include plastic (for credit/debit cards), purchase_order, paypal, amazon_mws, hosted, ogone, and paypal_ec | String | Read only |
gateway_type | The payment gateway type for this payment. This should correspond to a value in hosted_payment_gateways or payment_gateways. | String | Read Only |
processor_response | The processor response string from the payment gateway. This will include their transaction or reference number. | String | Read only |
processor_response_details | If supported by the payment gateway integration, this will include additional information from the payment gateway's response. | String | Read only |
purchase_order | The PO value entered by the customer during checkout (for purchase order payment types). | String | Read only |
cc_number_masked | The masked credit card number used for this payment (for plastic payment types). | String | Read only |
cc_type | The type of credit card such as Visa or MasterCard (for plastic payment types). | String | Read only |
cc_exp_month | The credit card expiration month (for plastic payment types). | String | Read only |
cc_exp_year | The credit card expiration year (for plastic payment types). | String | Read only |
fraud_protection_score | If this payment gateway set is configured with a fraud protection system, the fraud score for this payment will be listed here. | Decimal | Read only |
paypal_payer_id | The payer id for this payment (for Paypal payment types). | String | Read only |
third_party_id | The identifer for the third party provider for this payment (for hosted payment types). | String | Read only |
amount | The total amount of this payment. | Decimal | Read only |
date_created | The date this resource was created. | Date | Read only |
date_modified | The date this resource was last modified. | Date | Read only |
Example Representation
{ "_links": { "curies": [ { "name": "fx", "href": "https://api.foxycart.com/rels/{rel}", "templated": true } ], "self": { "href": "https://api-sandbox.foxycart.com/payments/18198", "title": "This Payment" }, "fx:store": { "href": "https://api-sandbox.foxycart.com/stores/66", "title": "This Store" }, "fx:transaction": { "href": "https://api-sandbox.foxycart.com/transactions/3845522", "title": "This Transaction" } }, "type": "plastic", "gateway_type": "authorize", "processor_response": "Authorize.net Transaction ID:2233990980", "processor_response_details": "", "purchase_order": "", "cc_number_masked": "xxxxxxxxxxxx1111", "cc_type": "Visa", "cc_exp_month": "01", "cc_exp_year": "2017", "fraud_protection_score": 0, "paypal_payer_id": "", "third_party_id": "", "amount": 20.15, "date_created": "2015-05-21T14:22:09-0700", "date_modified": "2015-05-21T14:22:09-0700" }
<?xml version="1.0" encoding="UTF-8"?> <resource href="https://api-sandbox.foxycart.com/payments/18198" rel="https://api.foxycart.com/rels/payment"> <link rel="self" href="https://api-sandbox.foxycart.com/payments/18198" title="This Payment"/> <link rel="https://api.foxycart.com/rels/store" href="https://api-sandbox.foxycart.com/stores/66" title="This Store"/> <link rel="https://api.foxycart.com/rels/transaction" href="https://api-sandbox.foxycart.com/transactions/3845522" title="This Transaction"/> <type>plastic</type> <gateway_type>authorize</gateway_type> <processor_response>Authorize.net Transaction ID:2233990980</processor_response> <processor_response_details></processor_response_details> <purchase_order></purchase_order> <cc_number_masked>xxxxxxxxxxxx1111</cc_number_masked> <cc_type>Visa</cc_type> <cc_exp_month>01</cc_exp_month> <cc_exp_year>2017</cc_exp_year> <fraud_protection_score>0</fraud_protection_score> <paypal_payer_id></paypal_payer_id> <third_party_id></third_party_id> <amount>20.15</amount> <date_created>2015-05-21T14:22:09-0700</date_created> <date_modified>2015-05-21T14:22:09-0700</date_modified> </resource>
{ "class": [ "payment" ], "properties": { "type": "plastic", "gateway_type": "authorize", "processor_response": "Authorize.net Transaction ID:2233990980", "processor_response_details": "", "purchase_order": "", "cc_number_masked": "xxxxxxxxxxxx1111", "cc_type": "Visa", "cc_exp_month": "01", "cc_exp_year": "2017", "fraud_protection_score": 0, "paypal_payer_id": "", "third_party_id": "", "amount": 20.15, "date_created": "2015-05-21T14:22:09-0700", "date_modified": "2015-05-21T14:22:09-0700" }, "links": [ { "rel": [ "self" ], "href": "https://api-sandbox.foxycart.com/payments/18198" }, { "rel": [ "https://api.foxycart.com/rels/store" ], "href": "https://api-sandbox.foxycart.com/stores/66" }, { "rel": [ "https://api.foxycart.com/rels/transaction" ], "href": "https://api-sandbox.foxycart.com/transactions/3845522" } ] }
Zoomable Resources
This resource has no linked resources which can be "zoomed" in on, filtered and embedded within this resource.