Get Payments Using Merchant Reference Number
GET/v1/payments
Click on Send API Request after entering the required data, to see how to look up a Payment using the merchant reference number used in the original request.
Request
Query Parameters
This is the merchant reference number created by the merchant and submitted as part of the Payments request.
Possible values: <= 50
Default value: 10
This is the total number of records to return.
Default value: 0
This is the starting position, where 0 is the first record.
This is the start date in UTC. Default = 30 days before the endDate.
This is the end date in UTC. Default = current date and time.
Responses
- 200
OK
Response Headers
Content-Type
string
- application/json
- Schema
- Example (from schema)
- Lookup Card Payment
Schema
An array of Payments.
meta
object
Contains meta info for the pagination APIs
This is the number of records returned in the lookup.
This is the number of records returned per page.
This is the page of records on which the lookup starts.
{
"payments": [
{
"id": "3aeb9c63-6386-46a3-9f8e-f452e722228a",
"availableToSettle": 0,
"childAccountNum": "3216549877",
"txnTime": "2023-01-19T16:33:49Z",
"paymentType": "CARD",
"status": "RECEIVED",
"gatewayResponse": {
"id": "string",
"processor": "string",
"code": "string",
"responseCode": "string",
"avsCode": "string",
"avsResponse": "MATCH",
"balanceResponse": "string",
"mid": "string",
"terminalId": "string",
"batchNumber": "string",
"seqNumber": "string",
"effectiveDate": "string",
"financingType": "string",
"plan": "string",
"gracePeriod": "string",
"term": "string",
"responseId": "string",
"requestId": "string",
"description": "string",
"authCode": "string",
"txnDateTime": "string",
"referenceNbr": "string",
"responseReasonCode": "string",
"cvvVerification": "MATCH",
"cvv2Result": "string",
"status": "string",
"orderId": "string",
"profile": {
"id": "string",
"status": "string",
"merchantCustomerId": "string",
"locale": "en_US",
"firstName": "Venkata Suresh",
"lastName": "Chagalamarri",
"email": "paysafe@gmail.com",
"phone": "1234567891",
"dateOfBirth": {
"day": 6,
"month": 5,
"year": 1998
},
"mobile": "9846573804",
"gender": "M",
"nationality": "Indian",
"identityDocuments": [
{
"identityDocuments": [
{
"type": "SOCIAL_SECURITY",
"documentNumber": "SSN123456"
},
{
"type": "PASSPORT",
"documentNumber": "1234567",
"issuingCountry": "USA",
"issuingCountrySubdvision": "SA",
"expiryDate": {
"month": 12,
"year": 2022
}
}
]
}
]
}
},
"riskReasonCode": [
1001
],
"settlements": [
{
"id": "25f6dadf-176a-415f-95c9-6ff39ff697ba",
"paymentType": "CARD",
"availableToRefund": 0,
"childAccountNum": "1234567898",
"txnTime": "2024-11-08T11:57:08.090Z",
"status": "RECEIVED",
"error": {
"code": "5068",
"message": "Field error(s)",
"details": [
"Either you submitted a request that is missing a mandatory field or the value of a field does not match the format expected."
],
"fieldErrors": [
{
"field": "accountId",
"error": "AccountId is missing in the request. If multiple accounts are registered with same currency, accountId is mandatory."
}
]
},
"riskReasonCode": [
0
],
"gatewayResponse": {
"id": "string",
"processor": "string",
"code": "string",
"responseCode": "string",
"avsCode": "string",
"avsResponse": "MATCH",
"balanceResponse": "string",
"mid": "string",
"terminalId": "string",
"batchNumber": "string",
"seqNumber": "string",
"effectiveDate": "string",
"financingType": "string",
"plan": "string",
"gracePeriod": "string",
"term": "string",
"responseId": "string",
"requestId": "string",
"description": "string",
"authCode": "string",
"txnDateTime": "string",
"referenceNbr": "string",
"responseReasonCode": "string",
"cvvVerification": "MATCH",
"cvv2Result": "string",
"status": "string",
"orderId": "string",
"profile": {
"id": "string",
"status": "string",
"merchantCustomerId": "string",
"locale": "en_US",
"firstName": "Venkata Suresh",
"lastName": "Chagalamarri",
"email": "paysafe@gmail.com",
"phone": "1234567891",
"dateOfBirth": {
"day": 6,
"month": 5,
"year": 1998
},
"mobile": "9846573804",
"gender": "M",
"nationality": "Indian",
"identityDocuments": [
{
"identityDocuments": [
{
"type": "SOCIAL_SECURITY",
"documentNumber": "SSN123456"
},
{
"type": "PASSPORT",
"documentNumber": "1234567",
"issuingCountry": "USA",
"issuingCountrySubdvision": "SA",
"expiryDate": {
"month": 12,
"year": 2022
}
}
]
}
]
}
},
"gatewayReconciliationId": "a5c80e61-e747-455f-843d-2b9526f9963e",
"liveMode": true,
"updatedTime": "2023-01-19T10:48:04Z",
"statusTime": "2023-01-19T10:48:04Z",
"merchantRefNum": "string",
"amount": 0,
"dupCheck": true,
"splitpay": [
{
"linkedAccount": "123124124",
"amount": 505,
"percent": 5
}
],
"airlineTravelDetails": {
"passengerName": "Venkata Suresh",
"departureDate": "2022-12-20",
"origin": "SXF",
"computerizedReservationSystem": "DATS",
"ticket": {
"ticketNumber": "1234567891011",
"isRestrictedTicket": true
},
"customerReferenceNumber": "10987654321",
"travelAgency": {
"code": "MY AGENT",
"name": "MYAGENT347"
},
"tripLegs": {
"leg1": {
"flight": {
"carrierCode": "LH",
"flightNumber": "0799"
},
"serviceClass": "F",
"isStopOverAllowed": true,
"destination": "SOF",
"fareBasis": "VMAY",
"departureDate": "2022-12-20"
},
"leg2": {
"flight": {
"carrierCode": "LH",
"flightNumber": "0799"
},
"serviceClass": "F",
"isStopOverAllowed": true,
"destination": "SOF",
"fareBasis": "VMAY",
"departureDate": "2022-12-20"
},
"leg3": {
"flight": {
"carrierCode": "LH",
"flightNumber": "0799"
},
"serviceClass": "F",
"isStopOverAllowed": true,
"destination": "SOF",
"fareBasis": "VMAY",
"departureDate": "2022-12-20"
},
"leg4": {
"flight": {
"carrierCode": "LH",
"flightNumber": "0799"
},
"serviceClass": "F",
"isStopOverAllowed": true,
"destination": "SOF",
"fareBasis": "VMAY",
"departureDate": "2022-12-20"
}
},
"passengerNameRecord": "ABCDE12345",
"additionalBookingReference": "string",
"totalFare": 0,
"totalFee": 0,
"totalTaxes": 0,
"passengers": "string"
}
}
],
"error": {
"code": "5068",
"message": "Field error(s)",
"details": [
"Either you submitted a request that is missing a mandatory field or the value of a field does not match the format expected."
],
"fieldErrors": [
{
"field": "accountId",
"error": "AccountId is missing in the request. If multiple accounts are registered with same currency, accountId is mandatory."
}
]
},
"statusReason": "string",
"authentication": {
"id": "5d4db3bc-34c9-417f-a051-0d992ad9284e",
"eci": 5,
"cavv": "AAABBhkXYgAAAAACBxdiENhf7A+=",
"xid": "aWg4N1ZZOE53TkFrazJuMmkyRDA=",
"status": "COMPLETED ",
"merchantRefNum": "merchantABC-123-authentications",
"threeDEnrollment": "Y",
"threeDResult": "Y",
"signatureStatus": "Y",
"error": {
"code": "5068",
"message": "Field error(s)",
"details": [
"Either you submitted a request that is missing a mandatory field or the value of a field does not match the format expected."
],
"fieldErrors": [
{
"field": "accountId",
"error": "AccountId is missing in the request. If multiple accounts are registered with same currency, accountId is mandatory."
}
]
}
},
"gatewayReconciliationId": "4bbfba66-a15b-4fa5-ad77-c209ffdb914f",
"updatedTime": "2023-01-19T08:37:50Z",
"statusTime": "2023-01-19T08:37:50Z",
"availableToRefund": 0,
"links": {
"rel": "redirect_payment",
"href": "http://api.paysafe.com/card/redirect/372b5ee7-6360-4403-b444-164f8f1d2709",
"method": "GET"
},
"liveMode": true,
"billingDetails": {
"id": "string",
"status": "string",
"nickName": "Home",
"street": "Street",
"street1": "street1",
"street2": "street2",
"city": "Toronto",
"state": "ON",
"country": "CA",
"zip": "M5H 2N2",
"phone": "8765846321"
},
"customerProfile": {
"id": "string",
"status": "string",
"merchantCustomerId": "string",
"locale": "en_US",
"firstName": "Venkata Suresh",
"lastName": "Chagalamarri",
"email": "paysafe@gmail.com",
"phone": "1234567891",
"dateOfBirth": {
"day": 6,
"month": 5,
"year": 1998
},
"mobile": "9846573804",
"gender": "M",
"nationality": "Indian",
"identityDocuments": [
{
"identityDocuments": [
{
"type": "SOCIAL_SECURITY",
"documentNumber": "SSN123456"
},
{
"type": "PASSPORT",
"documentNumber": "1234567",
"issuingCountry": "USA",
"issuingCountrySubdvision": "SA",
"expiryDate": {
"month": 12,
"year": 2022
}
}
]
}
]
},
"merchantRefNum": "445186567390019700",
"amount": 500,
"dupCheck": true,
"settleWithAuth": true,
"preAuth": true,
"partialAuth": {
"requested": true,
"amountDue": 1000,
"originalAmount": 2000
},
"paymentHandleToken": "SAJyTBzCvS8YHwwb",
"customerIp": "172.0.0.1",
"description": "Magazine subscription",
"currencyCode": "USD",
"level2level3": {
"exemptLocalTax": true,
"localTaxAmount": 1500,
"nationalTaxAmount": 0,
"freightAmount": 0,
"dutyAmount": 0,
"destinationZip": "90210",
"destinationCountry": "US",
"shipFromZip": "90211",
"lineItems": {
"description": "Disney Cruise Line",
"productCode": "DCL",
"quantity": 4,
"unitAmount": 120000,
"taxRate": 5,
"taxAmount": 24000,
"totalAmount": 0
}
},
"accordD": {
"financingType": "DEFERRED_PAYMENT",
"plan": "124",
"gracePeriod": 12,
"term": 12
},
"recipient": {
"dateOfBirth": {
"day": 6,
"month": 5,
"year": 1998
},
"zip": "CB24 9AD",
"lastName": "Chagalamarri",
"accountNumber": "ABC1234567890"
},
"splitpay": {
"linkedAccount": "123124124",
"amount": 505,
"percent": 5
},
"storedCredentialDetails": {
"type": "ADHOC",
"occurrence": "INITIAL",
"initialTransactionId": "string",
"externalInitialTransactionId": "string"
},
"airlineTravelDetails": {
"passengerName": "Venkata Suresh",
"departureDate": "2022-12-20",
"origin": "SXF",
"computerizedReservationSystem": "DATS",
"ticket": {
"ticketNumber": "1234567891011",
"isRestrictedTicket": true
},
"customerReferenceNumber": "10987654321",
"travelAgency": {
"code": "MY AGENT",
"name": "MYAGENT347"
},
"tripLegs": {
"leg1": {
"flight": {
"carrierCode": "LH",
"flightNumber": "0799"
},
"serviceClass": "F",
"isStopOverAllowed": true,
"destination": "SOF",
"fareBasis": "VMAY",
"departureDate": "2022-12-20"
},
"leg2": {
"flight": {
"carrierCode": "LH",
"flightNumber": "0799"
},
"serviceClass": "F",
"isStopOverAllowed": true,
"destination": "SOF",
"fareBasis": "VMAY",
"departureDate": "2022-12-20"
},
"leg3": {
"flight": {
"carrierCode": "LH",
"flightNumber": "0799"
},
"serviceClass": "F",
"isStopOverAllowed": true,
"destination": "SOF",
"fareBasis": "VMAY",
"departureDate": "2022-12-20"
},
"leg4": {
"flight": {
"carrierCode": "LH",
"flightNumber": "0799"
},
"serviceClass": "F",
"isStopOverAllowed": true,
"destination": "SOF",
"fareBasis": "VMAY",
"departureDate": "2022-12-20"
}
},
"passengerNameRecord": "ABCDE12345",
"additionalBookingReference": "string",
"totalFare": 0,
"totalFee": 0,
"totalTaxes": 0,
"passengers": "string"
},
"fundingTransaction": {
"type": "SVDW_FUNDS_TRANSFER",
"processorAppliedType": "SVDW_FUNDS_TRANSFER"
},
"card": {
"cardNum": "4111111111111111",
"cardExpiry": {
"month": 12,
"year": 2022
},
"cvv": "string",
"holderName": "Suresh's card",
"cardType": "AM",
"lastDigits": "string",
"nickName": "string",
"cardBin": "411111"
}
}
],
"meta": {
"numberOfRecords": 1,
"limit": 10,
"page": 1
}
}
{
"meta": {
"numberOfRecords": 1,
"limit": 10,
"page": 1
},
"payments": [
{
"id": "8190c675-6d68-4cd7-a29c-55b406addaeb",
"amount": 1900,
"merchantRefNum": "merchantRefNum-145",
"settleWithAuth": false,
"paymentHandleToken": "SChfCGCURe5NiLIv",
"authCode": "107212",
"txnTime": "2018-12-14T15:12:18Z",
"customerIp": "10.10.12.64",
"description": "Magazine subscription",
"currencyCode": "GBP",
"paymentType": "CARD",
"status": "COMPLETED",
"avsResponse": "MATCH",
"cvvVerification": "MATCH",
"availableToSettle": 40
}
]
}