Send funds to a payee
POST /api/transaction
Use this call to transfer funds from a sender to a payee.
When you POST a pull or push transaction, send the cardToken
, amount
, and RequestId
in the request body JSON.
When P2C receives the POST request, it uses the token to retrieve the debit card number and performs the transaction. The API response includes the card token, amount transferred, and a transaction status which indicates success/failure.
Request attributes
Attribute | Description |
---|---|
sourceSenderId string | Merchant ID. |
sourceSenderName string | Merchant name. |
sourceMcc string | Merchant Category Code (MCC). 4-digits that a credit card issuer uses to categorize consumer transactions for their card. |
RequestId GUID | This attribute corresponds to the TransacationRequestId in the response.Required |
cardToken string | Token for the signed up debit card. Required |
amount integer | Transaction amount in cents. Required |
Sample request POST /api/transaction
{
"sourceSenderId": "298fa967-97dp-vvy6-afag-11sghvk6nx12",
"sourceSenderName": "Smiths",
"sourceMcc": "5434",
"requestId": "298fa967-97dp-vvy6-afag-11sghvk6nx12",
"cardToken": "12975twtr423hbs34bn670103",
"amount": 10
}
Response attributes
Attribute | Description |
---|---|
transactionRequestId string | This attribute corresponds to the RequestId in the request. |
amount integer | Transaction amount in cents. |
transactionRequestedAt string | Date and time the transaction was requested. |
transactionStatus string | Status of the transaction: - Succeeded - Pending - Failed - Rejected |
errorDescription string | Description of any error that might have occurred. |
creditCardId string | Token for the signed up debit card. |
railId string | The processor used to perform the transaction - RS2 - McSend - TabaPay |
network string | Card network. - Visa - Mastercard - ET - PULSE - STAR - NYCE - Accel - RPPS - MoneySend |
retrievalReferenceId GUID | Unique tracking identifier for this transaction in the processors to correlate this transaction to the processors. |
actualTransactionDoneAt string | Actual time the transaction was sent to the processor. |
paymentSent boolean | True if the payment passed all the way to the processor successfully, otherwise false. |
requestApproved boolean | True if the payment passed all the way to the processor successfully, otherwise false. |
responseReceived boolean | True if P2C received a response from the external processor, otherwise false. |
responseCode string | An ISO 8583 two-digit code signifying the transaction result. For example, 00 means successful. |
responseDescription string | An ISO 8583 string description of the transaction result. For example, Approved. |
traceNumber string | Unique number that is assigned to a transaction when it leaves the merchant bank until it arrives at the cardholder bank. |
error string | Descriptive error, if relevant. |
transactionRequestBatchId string | If a request is part of a batch, this ID shows. |
sourceSenderName string | Name of the sender of the payment. |
*sourceMcc string | Merchant Category Code (MCC). 4-digits that a credit card issuer uses to categorize consumer transactions for their card. |
isSuccessful boolean | True if the transaction is successful, otherwise false. |
Sample response POST /api/transaction
{
"result": {
"transactionRequestId": "e91ea2c5-e8dc-4790-acf7-5dea1cab7216",
"amount": 100,
"transactionRequestedAt": "2022-09-10T00:28:37.76",
"transactionStatus": "Succeeded",
"errorDescription": "null",
"creditCardId": "OMOZBSFLNAUG8E2134UDH18WILO2QDA9K6XQVN",
"railId": "RS2",
"network": "visa",
"retrievalReferenceId": "null"
"actualTransactionDoneAt": "2022-09-10T12:28:51",
"paymentSent": true,
"requestApproved": true,
"responseReceived": true,
"responseCode": "00",
"responseDescription": "Approved",
"traceNumber": "null",
"error": "null",
"sourceSenderName": "Cooks",
"sourceMcc": "5981",
},
"isSuccessful": true
}
Updated 2 months ago