Create a credit memo / Record offline payment
POST/api/v3/transaction
Create a credit memo for a customer.
Notes:
- The transaction_type value MUST be "cre"
- The gateway_method value MUST be "credit"
- The gateway_status value should be either 1 (to indicate the payment was successful) or 0 (zero, to log a payment that failed/was declined)
A payment transaction is used to indicate an invoice has been paid (either entirely paid, or partially paid for).
Note: This does not actually charge a credit card or an ACH account. If you're trying to do that, please see the attempt a payment endpoint.
Notes:
- The transaction_type value MUST be “pay”
- The gateway_status value should be either 1 (to indicate the payment was successful) or 0 (zero, to log a payment that failed/was declined)
- The gateway_method value MUST be one of:
visa
,mastercard
,american-express
,discover
,check
,paypal
,credit
,ach
Request
- application/json
Body
Customer ID #
Payment gateway ID #
Payment gateway status (1 for success, 0 for failure)
Payment gateway transaction identifier
Payment gateway method
A customer-facing error message indicating why the transaction declined/failed
Transaction external key value
Total transaction amount (refunds will be negative)
Date of the transaction
Transaction type (one of: pay, ref, cre, spl)
Transaction method
Transaction details
Custom field #1
Custom field #2
Custom field #3
Custom field #4
Custom field #5
Transaction memo
Responses
- 201
- 400
- 401
Object was created successfully
- application/json
- Schema
- Example (from schema)
- Example 1
Schema
response
object
{
"code": 0,
"status": "string",
"message": "string",
"details": {},
"response": {
"id": 0
}
}
{
"code": 201,
"status": "OK",
"message": "",
"details": {},
"response": {
"id": 1234
}
}
Bad request
- application/json
- Schema
- Example (from schema)
- Example 1
Schema
{
"code": 0,
"status": "string",
"message": "string",
"details": {},
"response": true
}
{
"code": 400,
"status": "Error",
"message": "Missing or invalid parameter.",
"details": {},
"response": false
}
Authentication error
- application/json
- Schema
- Example (from schema)
- Example 1
Schema
{
"code": 0,
"status": "string",
"message": "string",
"details": {},
"response": true
}
{
"code": 401,
"status": "Error",
"message": "Invalid or incorrect authorization [Missing (basic) authorization header.]",
"details": {},
"response": false
}