# Refund payment without reference This endpoint is used to refund a payment without reference. Endpoint: POST /payments/refunds Version: 2.0.0 Security: bearerAuth, basicAuth ## Request fields (application/json): - `transId` (string, required) Transaction ID created in your system. It should be unique for each payment. Example: "test-TransactionId01" - `amount` (object, required) - `amount.value` (number, required) Total order amount in smallest currency unit including taxes, shipping costs, discounts, etc. - `amount.currency` (string, required) 3-character ISO currency code. - `amount.taxTotal` (number) Total tax amount. - `refNr` (string) Your unique reference number for the specific operation. You can pass this value to reconcile different operations in a payment (authorization, capture, refund, etc) individually. - `billingAddress` (object) - `billingAddress.firstName` (string) First name of billing address. - `billingAddress.lastName` (string) Last name of billing address. - `billingAddress.streetName` (string) Street name of billing address. - `billingAddress.streetNumber` (string) Street number of billing address. - `billingAddress.addressLine2` (string) Address line 2 of billing address. - `billingAddress.addressLine3` (string) Address line 3 of billing address. - `billingAddress.city` (string) City of billing address. - `billingAddress.state` (string) State of billing address. - `billingAddress.country` (string) 3 character ISO country code of billing address. - `billingAddress.postalCode` (string) Postal code of billing address. - `shipping` (object) - `shipping.address` (object) - `shipping.address.firstName` (string) Shipping first name. - `shipping.address.lastName` (string) Shipping last name. - `shipping.address.companyName` (string) Shipping company name. Applicable, when the entity where the goods are being delivered is a business entity. - `shipping.address.streetName` (string) Shipping street. - `shipping.address.streetNumber` (string) Shipping street number. - `shipping.address.addressLine2` (string) Address line 2 of shipping address. - `shipping.address.addressLine3` (string) Address line 3 of shipping address. - `shipping.address.city` (string) Shipping city. - `shipping.address.state` (string) State of shipping address. - `shipping.address.country` (string) 3 character ISO country code of shipping address. - `shipping.address.postalCode` (string) Shipping postal code. - `shipping.type` (string) Shipping method. - `statementDescriptor` (string) Short, clear description of the transaction that appears on the customer's statement. - `customerInfo` (object) - `customerInfo.merchantCustomerId` (string) A unique identifier for the customer, assigned by the merchant's system. - `customerInfo.customerType` (string) Specifies the type of customer, such as "individual" or "business". - `customerInfo.firstName` (string) First name of the customer. - `customerInfo.lastName` (string) Last name (surname) of the customer. - `customerInfo.email` (string, required) Email address of the customer. - `customerInfo.phone` (object) - `customerInfo.phone.countryCode` (string) Country code of the phone number. - `customerInfo.phone.number` (string) Phone number. - `customerInfo.birthDate` (string) Birth date of the customer in YYYY-MM-DD format. - `browserInfo` (object) - `browserInfo.acceptHeaders` (string) Exact content of the HTTP accept headers as sent from the customer’s browser. - `browserInfo.ipAddres` (string) IP address of the browser as returned by the HTTP headers. - `browserInfo.sessionId` (string) Customer´s Session ID. - `metadata` (object) A collection of additional custom data provided by the merchant to store extra information about the transaction. This is a set of JSON key value pairs passed by the merchant. Axepta Online will return the data as it is in the response. - `paymentMethods` (object) - `paymentMethods.card` (object) - `paymentMethods.card.number` (string, required) The card number or the pseudo card number of the payment card. - `paymentMethods.card.cardholderName` (string, required) The name of the cardholder as it appears on the payment card. - `paymentMethods.card.expiryDate` (string, required) The expiration date of the card in YYYYMM format. - `paymentMethods.card.brand` (string, required) The brand or network of the card, such as "visa", "mastercard". - `paymentMethods.card.securityCode` (string) The Card Security Code, also known as CVV or CVC. - `paymentMethods.card.paymentOfWinnings` (boolean) In the case of the acquirer EMS (Omnipay) the merchant can control CFT credit notes in this way.Transfer PaymentOfWinnings=True to credit a win rather than simply repaying a paid amount. - `paymentMethods.card.paymentData` (object) Additional data if PaymentOfWinnings=True. - `paymentMethods.card.paymentData.senderData` (object) - `paymentMethods.card.paymentData.senderData.accountNumber` (string) Contains the sender’s bank account number from which the funds are to be taken. - `paymentMethods.card.paymentData.senderData.name` (string) Contains the name of the person or business for the account from which funds are to be taken. - `paymentMethods.card.paymentData.senderData.address` (string) Contains the address of the person or business for the account from which funds are to be taken. - `paymentMethods.card.paymentData.senderData.city` (string) Contains the city of the person or business for the account from which funds are to be taken. - `paymentMethods.card.paymentData.senderData.countryCode` (string) Contains the country of the person or business’s account from which funds are to be taken. To be sent in number 3 Digit ISO standard. - `paymentMethods.card.paymentData.senderData.transactionMethod` (string) It indicates the method used by the sender to fund a Payment of winning transaction. Enum: "CREDIT", "DEBIT", "PREPAID", "CASH", "DEPOSIT_ACCOUNT", "MOBILE_MONEY_ACCOUNT" - `paymentMethods.card.paymentData.senderData.accountType` (string) Enum: "RTN_AND_BANK_ACCOUNT_NUMBER", "IBAN", "CARD_ACCOUNT", "IBAN_AND_BIC" - `paymentMethods.card.paymentData.recipientData` (object) - `paymentMethods.card.paymentData.recipientData.name` (string) - `paymentMethods.directDebit` (object) - `paymentMethods.directDebit.account` (object, required) - `paymentMethods.directDebit.account.number` (string, required) International Bank Account Number. - `paymentMethods.directDebit.account.code` (string) Bank Identifier Code. - `paymentMethods.directDebit.account.bankName` (string) Bank name. - `paymentMethods.directDebit.account.accountHolderName` (string, required) Account holder name. ## Response 200 fields (application/json): - `payId` (string) A unique identifier assigned by Axepta Online to the payment. This ID remains constant throughout the lifecycle of the payment and is used to track and reference the payment across all subsequent operations, such as authorization, capture, refund, or cancellation. - `merchantId` (string) Merchant ID assigned by Axepta Online. - `transId` (string) Transaction ID provided by you in the request. - `xId` (string) A unique identifier assigned by Axepta Online for each operation in the payment. For example: xId will be different for the authorization and capture operations of a payment whereas payId will be same. - `refNr` (string) Reference number provided by you in the request. - `status` (string) Status of the transaction. - `responseCode` (string) Response code of the transaction. - `responseDescription` (string) Response description associated with the response code. - `metadata` (object) A collection of additional custom data provided by you to store extra information about the transaction. This is a set of JSON key value pairs as you passed in the request. - `paymentMethods` (object) - `paymentMethods.card` (object) - `paymentMethods.card.providerResponseCode` (string) Returned only when Acquirer is Clearhaus or MasaPay. - `paymentMethods.card.providerResponseText` (string) Returned only when Acquirer is Clearhaus or MasaPay. Information is passed only when status is FAILED. - `paymentMethods.card.providerTransactionId` (string) Provider transaction ID. Returned only when Acquirer is Clearhaus. - `paymentMethods.card.providerApprovalCode` (number) Approval code returned by provider. ## Response 400 fields (application/json): - `field` (string) Example: "transId" - `error` (string) Example: "This field is required." ## Response 422 fields (application/json): - `payId` (string) A unique identifier assigned by Axepta Online to the payment. This ID remains constant throughout the lifecycle of the payment and is used to track and reference the payment across all subsequent operations, such as authorization, capture, refund, or cancellation. - `merchantId` (string) Merchant ID assigned by Axepta Online. - `transId` (string) Transaction ID provided by you in the request. - `xId` (string) A unique identifier assigned by Axepta Online for each operation in the payment. For example: xId will be different for the authorization and capture operations of a payment whereas payId will be same. - `refNr` (string) Reference number provided by you in the request. - `status` (string) Status of the transaction. - `responseCode` (string) Response code of the transaction. - `responseDescription` (string) Response description associated with the response code. - `metadata` (object) A collection of additional custom data provided by you to store extra information about the transaction. This is a set of JSON key value pairs as you passed in the request. - `paymentMethods` (object) - `paymentMethods.card` (object) - `paymentMethods.card.providerResponseCode` (string) Returned only when Acquirer is Clearhaus or MasaPay. - `paymentMethods.card.providerResponseText` (string) Returned only when Acquirer is Clearhaus or MasaPay. Information is passed only when status is FAILED. ## Response 500 fields (application/json): - `responseCode` (string) Example: "A specific identifier for the error cause" - `responseDescription` (string) Example: "A brief message explaining the error"