| POST | /collectionattempts/{id}/payments | Creates a payment. |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Id | path | Guid | Yes | Colletion attempt id to apply the payment to |
| PaymentToken | body | string | Yes | Token for payment info provided by the payment processing gateway |
| PaymentAmount | body | decimal | Yes | The Payment Amount without Convenience fees |
| ConvenienceFee | body | decimal | No | The convenience fee |
| Payor | body | object | Yes | Payor information |
| CardType | body | string | Yes | The type of card being used: visa, master, american_express, discover, jcb, diners_club, dankort |
| LastFour | body | string | Yes | The last 4 digits of the card being used |
| Fingerprint | body | string | Yes | The card fingerprint from spreedly |
| PaymentMethod | body | string | No | The Payment Method: CC, DC, EC, CP, OTHER DEFAULTS ....to CC when not defined |
| IsFeePayment | body | bool | Yes | are we paying fees?, if so, we will use the fee gateway to process those fees |
| GatewayName | body | string | No | The Payment gateway to charge |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| FirstName | body | string | Yes | First name of the person making the payment |
| LastName | body | string | Yes | Last name of the person making the payment |
| Address | body | string | No | Address of the person making the payment -Default Values will be inserted if not supplied to meet data inetgrity rules |
| Address2 | body | string | No | Address2 of the person making the payment |
| City | body | string | No | City of the person making the payment -Default Values will be inserted if not supplied to meet data inetgrity rules |
| State | body | string | No | State of the person making the payment-Default Values will be inserted if not supplied to meet data inetgrity rules |
| Country | body | string | No | Country Code of the person making the payment--Default Values will be inserted if not supplied to meet data inetgrity rules |
| Zip | body | string | No | Zip Code of the person making the payment |
| body | string | No | Email of the person making the payment--Default Values will be inserted if not supplied to meet data inetgrity rules | |
| Phone | body | string | No | Phone of the person making the payment |
| Note | body | string | No | Note taken regarding the person making the payment |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Result | form | PaymentProcessingResult | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Errors | form | List<string> | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| PaymentId | form | Guid | No | Guid/unique identifier for the payment |
| OriginatingAttemptId | form | Guid | No | Guid/unique identifier reference to the original attempt |
| AmountApplied | form | decimal | No | |
| PaymentProcessingOutcome | form | PaymentProcessingOutcome | No | |
| IsSuccessful | form | bool | No | |
| TsysMappedGatewayResponse | form | string | No |
| Name | Value |
|---|---|
| None | 0 |
| Done | 1 |
| VoidSecurityFee | 4 |
| CashPaymentResultsInZeroBalance | 8 |
| LockDownPage | 16 |
| CardTokenNotSaved | 32 |
| PaymentDeclined | 64 |
| FailedAvsCheck | 128 |
| FailedCvv2Check | 256 |
| PaymentFailedToSave | 512 |
| OverPayment | 1024 |
| OverRefund | 2048 |
| RemainderLessThanGatewayMinimum | 4096 |
| PaymentUnderGatewayMinimum | 8192 |
| PaymentOverGatewayMaximum | 16384 |
| RefundWasSuccessful | 32768 |
| NoGatewayResponse | 65536 |
| NoGatewayRequest | 131072 |
| OperationNotSupportedByGateway | 262144 |
| FailedAutoPaymentAllocation | 524288 |
| FailedAutoRefundAllocation | 1048576 |
| ECashPaymentBarCodeOutstanding | 2097152 |
| CardDeclinedRecently | 4194304 |
| CardUsedTooRecently | 8388608 |
| MissingCardFingerprint | 16777216 |
| MaximumCardsReached | 33554432 |
| MaximumPaymentAttempts | 67108864 |
| FraudCheckFailure | 134217728 |
| ChargebackCard | 268435456 |
| PhoneNumberAssociatedWithChargebacks | 536870912 |
To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json
To embed the response in a jsonp callback, append ?callback=myCallback
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /collectionattempts/{id}/payments HTTP/1.1
Host: api.paylock.com
Accept: application/json
Content-Type: application/json
Content-Length: length
{"id":"00000000-0000-0000-0000-000000000000","paymentToken":"String","paymentAmount":0,"convenienceFee":0,"payor":{"firstName":"String","lastName":"String","address":"String","address2":"String","city":"String","state":"String","country":"String","zip":"String","email":"String","phone":"String","note":"String"},"cardType":"String","lastFour":"String","fingerprint":"String","paymentMethod":"String","isFeePayment":false,"gatewayName":"String"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length
{"result":{"paymentId":"00000000000000000000000000000000","originatingAttemptId":"00000000000000000000000000000000","amountApplied":0,"paymentProcessingOutcome":0,"isSuccessful":false,"tsysMappedGatewayResponse":"String"},"errors":["String"]}