POST v1/GlobalPayments/ImportPayment
Request Information
URI Parameters
None.
Body Parameters
Common.Dto.Post.GlobalPaymentsImportPayment| Name | Description | Type | Additional information |
|---|---|---|---|
| customerId | integer |
None. |
|
| amount | decimal number |
None. |
|
| globalPaymentsReferenceId | string |
None. |
|
| globalPaymentsTransactionId | string |
None. |
|
| gatewayId | integer |
Range: inclusive between 0 and 2147483647 |
|
| makeDefault | boolean |
None. |
|
| reference | string |
String length: inclusive between 0 and 500 |
|
| referenceDate | date |
None. |
|
| paymentAllocations | Collection of Common.Dto.Post.PaymentAllocation |
None. |
|
| autoAllocate | boolean |
None. |
|
| autoAllocateOrder | string |
None. |
Request Formats
application/json, text/json
Sample:
{
"customerId": 1,
"amount": 2.0,
"globalPaymentsReferenceId": "sample string 3",
"globalPaymentsTransactionId": "sample string 4",
"gatewayId": 1,
"makeDefault": true,
"reference": "sample string 6",
"referenceDate": "2025-11-03T19:49:47.7534525+00:00",
"paymentAllocations": [
{
"invoiceId": 1,
"amount": 2.0
},
{
"invoiceId": 1,
"amount": 2.0
}
],
"autoAllocate": true,
"autoAllocateOrder": "sample string 8"
}
Response Information
Resource Description
Common.Dto.Get.PaymentActivity| Name | Description | Type | Additional information |
|---|---|---|---|
| customerId | integer |
None. |
|
| status | string |
None. |
|
| effectiveTimestamp | date |
None. |
|
| createdTimestamp | date |
None. |
|
| source | string |
None. |
|
| method | string |
None. |
|
| transactionType | string |
None. |
|
| amount | decimal number |
None. |
|
| gatewayFee | decimal number |
None. |
|
| currency | string |
None. |
|
| transaction | Common.Dto.Get.Payment |
None. |
|
| paymentGateway | Common.Dto.Get.PaymentGateway |
None. |
|
| methodIsAch | boolean |
None. |
|
| isOutsidePayment | boolean |
None. |
|
| parentCustomerId | integer |
None. |
|
| reconciliationId | globally unique identifier |
None. |
|
| trigger | string |
None. |
|
| triggeringUserId | integer |
None. |
|
| attemptNumber | integer |
None. |
|
| customer | Common.Dto.Get.CustomerForPaymentActivity |
None. |
|
| paymentMethod | Common.Dto.Get.PaymentActivityPaymentMethod |
None. |
|
| invoices | Collection of Common.Dto.Get.InvoiceAllocationForPaymentActivity |
None. |
|
| id | integer |
None. |
|
| uri | string |
None. |
Response Formats
application/json, text/json
Sample:
{
"customerId": 1,
"status": "sample string 2",
"effectiveTimestamp": "2025-11-03T19:49:47.7599871+00:00",
"createdTimestamp": "2025-11-03T19:49:47.7599871+00:00",
"source": "sample string 5",
"method": "sample string 6",
"transactionType": "sample string 7",
"amount": 8.0,
"gatewayFee": 1.0,
"currency": "sample string 9",
"transaction": {
"paymentActivityId": 1,
"reference": "sample string 2",
"effectiveTimestamp": "2025-11-03T19:49:47.7599871+00:00",
"referenceDate": "2025-11-03T19:49:47.7599871+00:00",
"description": "sample string 4",
"customerId": 5,
"originalPaymentActivityId": 1,
"amount": 6.0,
"currency": "sample string 7",
"invoiceAllocations": [
{
"invoiceId": 1,
"invoiceNumber": 2,
"amount": 3.0,
"outstandingBalance": 4.0,
"invoiceTotal": 5.0,
"surchargingFee": 1.0,
"poNumber": "sample string 6",
"netsuiteId": "sample string 7",
"quickbooksId": 1,
"invoiceNote": "sample string 8",
"uri": "sample string 9"
},
{
"invoiceId": 1,
"invoiceNumber": 2,
"amount": 3.0,
"outstandingBalance": 4.0,
"invoiceTotal": 5.0,
"surchargingFee": 1.0,
"poNumber": "sample string 6",
"netsuiteId": "sample string 7",
"quickbooksId": 1,
"invoiceNote": "sample string 8",
"uri": "sample string 9"
}
],
"refunds": [],
"unallocatedAmount": 8.0,
"refundableAmount": 1.0,
"gatewayFee": 1.0,
"settlement": {
"status": "sample string 1",
"modifiedTimestamp": "2025-11-03T19:49:47.7599871+00:00",
"lastCheckedTimestamp": "2025-11-03T19:49:47.7599871+00:00",
"nextCheckTimestamp": "2025-11-03T19:49:47.7599871+00:00",
"message": "sample string 2"
},
"netsuiteId": "sample string 9",
"surchargingFee": 1.0,
"sendToNetsuite": true,
"sendToQuickbooksOnline": true,
"quickBooksId": 1,
"quickBooksAttemptNumber": 12,
"sageIntacctId": 1,
"sageIntacctAttemptNumber": 13,
"syncedToSageIntacct": true,
"disputeStatus": "sample string 15",
"disputeId": "sample string 16",
"id": 17,
"uri": "sample string 18"
},
"paymentGateway": {
"authorizationCode": "sample string 1",
"authorizationResponse": "sample string 2",
"gatewayId": 1,
"gatewayName": "sample string 3",
"secondaryTransactionNumber": "sample string 4",
"primaryGatewayFailure": "sample string 5",
"processorId": 1
},
"methodIsAch": false,
"isOutsidePayment": false,
"parentCustomerId": 1,
"reconciliationId": "932cea20-bdc9-44d8-a9ca-2bc8e6519c89",
"trigger": "sample string 10",
"triggeringUserId": 1,
"attemptNumber": 11,
"customer": {
"id": 1,
"firstName": "sample string 2",
"lastName": "sample string 3",
"companyName": "sample string 4",
"reference": "sample string 5",
"reference1": "sample string 6",
"reference2": "sample string 7",
"reference3": "sample string 8",
"salesTrackingCodes": [
{
"type": "sample string 1",
"code": "sample string 2",
"name": "sample string 3",
"id": 4,
"uri": "sample string 5"
},
{
"type": "sample string 1",
"code": "sample string 2",
"name": "sample string 3",
"id": 4,
"uri": "sample string 5"
}
]
},
"paymentMethod": {
"id": 1,
"firstName": "sample string 2",
"lastName": "sample string 3",
"firstSix": "sample string 4",
"lastFour": "sample string 5",
"cardType": "sample string 6",
"expirationMonth": 1,
"expirationYear": 1,
"maskedAccountNumber": "sample string 7",
"maskedTransitNumber": "sample string 8",
"bankAccountType": "sample string 9",
"externalCustomerId": "sample string 10",
"externalCardId": "sample string 11"
},
"invoices": [
{
"invoiceId": 1,
"invoiceNumber": 2,
"invoiceAmount": 3.0,
"invoiceTotal": 4.0,
"taxes": 5.0,
"discounts": 6.0,
"chargeGroups": [
{
"subscriptionId": 1,
"name": "sample string 1",
"description": "sample string 2",
"reference": "sample string 3",
"code": "sample string 4",
"charges": [
{
"chargeId": 1,
"subscriptionProductId": 1,
"quantity": 2.0,
"amount": 3.0,
"name": "sample string 4",
"description": "sample string 5",
"code": "sample string 6"
},
{
"chargeId": 1,
"subscriptionProductId": 1,
"quantity": 2.0,
"amount": 3.0,
"name": "sample string 4",
"description": "sample string 5",
"code": "sample string 6"
}
],
"customFields": [
{
"key": "sample string 1",
"friendlyName": "sample string 2",
"dataType": "sample string 3",
"value": {}
},
{
"key": "sample string 1",
"friendlyName": "sample string 2",
"dataType": "sample string 3",
"value": {}
}
],
"coupons": [
{
"subscriptionId": 1,
"couponCode": "sample string 2",
"sideEffects": {},
"id": 3,
"uri": "sample string 4"
},
{
"subscriptionId": 1,
"couponCode": "sample string 2",
"sideEffects": {},
"id": 3,
"uri": "sample string 4"
}
]
},
{
"subscriptionId": 1,
"name": "sample string 1",
"description": "sample string 2",
"reference": "sample string 3",
"code": "sample string 4",
"charges": [
{
"chargeId": 1,
"subscriptionProductId": 1,
"quantity": 2.0,
"amount": 3.0,
"name": "sample string 4",
"description": "sample string 5",
"code": "sample string 6"
},
{
"chargeId": 1,
"subscriptionProductId": 1,
"quantity": 2.0,
"amount": 3.0,
"name": "sample string 4",
"description": "sample string 5",
"code": "sample string 6"
}
],
"customFields": [
{
"key": "sample string 1",
"friendlyName": "sample string 2",
"dataType": "sample string 3",
"value": {}
},
{
"key": "sample string 1",
"friendlyName": "sample string 2",
"dataType": "sample string 3",
"value": {}
}
],
"coupons": [
{
"subscriptionId": 1,
"couponCode": "sample string 2",
"sideEffects": {},
"id": 3,
"uri": "sample string 4"
},
{
"subscriptionId": 1,
"couponCode": "sample string 2",
"sideEffects": {},
"id": 3,
"uri": "sample string 4"
}
]
}
]
},
{
"invoiceId": 1,
"invoiceNumber": 2,
"invoiceAmount": 3.0,
"invoiceTotal": 4.0,
"taxes": 5.0,
"discounts": 6.0,
"chargeGroups": [
{
"subscriptionId": 1,
"name": "sample string 1",
"description": "sample string 2",
"reference": "sample string 3",
"code": "sample string 4",
"charges": [
{
"chargeId": 1,
"subscriptionProductId": 1,
"quantity": 2.0,
"amount": 3.0,
"name": "sample string 4",
"description": "sample string 5",
"code": "sample string 6"
},
{
"chargeId": 1,
"subscriptionProductId": 1,
"quantity": 2.0,
"amount": 3.0,
"name": "sample string 4",
"description": "sample string 5",
"code": "sample string 6"
}
],
"customFields": [
{
"key": "sample string 1",
"friendlyName": "sample string 2",
"dataType": "sample string 3",
"value": {}
},
{
"key": "sample string 1",
"friendlyName": "sample string 2",
"dataType": "sample string 3",
"value": {}
}
],
"coupons": [
{
"subscriptionId": 1,
"couponCode": "sample string 2",
"sideEffects": {},
"id": 3,
"uri": "sample string 4"
},
{
"subscriptionId": 1,
"couponCode": "sample string 2",
"sideEffects": {},
"id": 3,
"uri": "sample string 4"
}
]
},
{
"subscriptionId": 1,
"name": "sample string 1",
"description": "sample string 2",
"reference": "sample string 3",
"code": "sample string 4",
"charges": [
{
"chargeId": 1,
"subscriptionProductId": 1,
"quantity": 2.0,
"amount": 3.0,
"name": "sample string 4",
"description": "sample string 5",
"code": "sample string 6"
},
{
"chargeId": 1,
"subscriptionProductId": 1,
"quantity": 2.0,
"amount": 3.0,
"name": "sample string 4",
"description": "sample string 5",
"code": "sample string 6"
}
],
"customFields": [
{
"key": "sample string 1",
"friendlyName": "sample string 2",
"dataType": "sample string 3",
"value": {}
},
{
"key": "sample string 1",
"friendlyName": "sample string 2",
"dataType": "sample string 3",
"value": {}
}
],
"coupons": [
{
"subscriptionId": 1,
"couponCode": "sample string 2",
"sideEffects": {},
"id": 3,
"uri": "sample string 4"
},
{
"subscriptionId": 1,
"couponCode": "sample string 2",
"sideEffects": {},
"id": 3,
"uri": "sample string 4"
}
]
}
]
}
],
"id": 12,
"uri": "sample string 13"
}