Use this endpoint to log a new dispute <\/p>\n\n\n\n

Sample Request<\/strong><\/p>POST <base url>\/arbiter\/api\/v1\/disputes
Content-Type: application\/json<\/code>
Authorization: Bearer <AccessToken><\/code>
\u00a0
{<\/code>
\"remoteTranId\":\u00a02137647237,<\/code>
\"dispenseType\":\u00a0\"No Dispense\",<\/code>
\"logComments\":\u00a0\"Non-Receipt of Goods, Services or Cash\"<\/code>
}<\/code> <\/cite><\/blockquote>\n\n\n\n

Request Payload Description<\/strong><\/p>\n\n\n\n

Field<\/th>	Field Name<\/th>	Data Type<\/th>	Length<\/th>	Required<\/th>	Description<\/th><\/tr><\/thead>
1<\/td>	remoteTranId<\/td>	Long<\/td>	<\/td>	Yes<\/td>	Remote transaction Id of the transaction. You get this from the result of the search performed using the search endpoint<\/td><\/tr>
2<\/td>	dispenseType<\/td>	String<\/td>	<\/td>	Yes<\/td>	Expected Value is any one of these: [ No Dispense | Partial Dispense ]<\/td><\/tr>
3<\/td>	logComents<\/td>	String<\/td>	<\/td>	Yes<\/td>	Comments that specify the nature of the dispute e.g “Non-Receipt of Goods, Services or Cash”<\/td><\/tr><\/tbody><\/table>\n\n\n\n <\/p>\n\n\n\n RESPONSE<\/h4>\n\n\n\n Response Message\u00a0 field description <\/strong><\/p>\n\n\n\n Field<\/th> Field Name<\/th> Description<\/th><\/tr><\/thead> 1<\/td> disputeLogId<\/td> The ID of the dispute<\/td><\/tr> 2<\/td> disputeLogCode<\/td> The dispute log code<\/td><\/tr> 3<\/td> acquirerCode<\/td> The acquirer code<\/td><\/tr> 4<\/td> pan<\/td> The pan used for the transaction<\/td><\/tr> 5<\/td> stan<\/td> The Systen Trace Audit Number of the transaction<\/td><\/tr> 6<\/td> terminalId<\/td> The Terminal ID the transaction was done on<\/td><\/tr> 7<\/td> terminalType<\/td> The type of terminal that was used for the transaction<\/td><\/tr> 8<\/td> tranDateTime<\/td> The date the transaction was done<\/td><\/tr> 9<\/td> settleDateTime<\/td> The proposed settlement date<\/td><\/tr> 10<\/td> tranType<\/td> The type of transaction that was done<\/td><\/tr> 11<\/td> tranAmt<\/td> The transaction amount<\/td><\/tr> 12<\/td> surchargeAmt<\/td> The surcharge amount on the transaction<\/td><\/tr> 13<\/td> dispenseType<\/td> The dispense type (either partial or none)<\/td><\/tr> 14<\/td> logComments<\/td> Comment that was sent when creating the dispute<\/td><\/tr> 15<\/td> acceptComments<\/td> Comments when accepting the claim<\/td><\/tr> 16<\/td> declineComments<\/td> Comments when a dispute is declined<\/td><\/tr> 17<\/td> validatedBy<\/td> User who validated the claim<\/td><\/tr> 18<\/td> validatedOn<\/td> The date the dispute was validated<\/td><\/tr> 19<\/td> penaltyFee<\/td> The penalty fee<\/td><\/tr> 20<\/td> oldStatus<\/td> Previous status of the dipsute<\/td><\/tr> 21<\/td> isVerified<\/td> <\/td><\/tr> 22<\/td> requestedAmount<\/td> The amount that was requested during the transaction<\/td><\/tr> 23<\/td> dispensedAmount<\/td> The amount dispensed during the transaction<\/td><\/tr> 24<\/td> remoteTranId<\/td> The remote transaction ID<\/td><\/tr> 25<\/td> settleCurrencyCode<\/td> The settlement currency code<\/td><\/tr> 26<\/td> tranCurrencyCode<\/td> The transaction currency code<\/td><\/tr> 27<\/td> settleCurrencyAlphaCode<\/td> The settlement currency alpha code<\/td><\/tr> 28<\/td> tranCurrencyAlphaCode<\/td> The transaction currency alpha code<\/td><\/tr> 29<\/td> disputeExpiryDate<\/td> The expected date the dispute is supposed to have closed<\/td><\/tr> 30<\/td> code<\/td> <\/td><\/tr> 31<\/td> issuerDomainnCode<\/td> The domain code of the issuer<\/td><\/tr> 32<\/td> acquirerDomainCode<\/td> The domain code of the acquirer<\/td><\/tr> 33<\/td> merchantDomainCode<\/td> The domain code of the merchant<\/td><\/tr> 34<\/td> acquirerName<\/td> The name of the acquirer<\/td><\/tr> 35<\/td> issuerName<\/td> The name of the issuer<\/td><\/tr> 36<\/td> imageEvidence<\/td> <\/td><\/tr> 37<\/td> disputeJournal<\/td> Journal sent by the acquirer<\/td><\/tr> 38<\/td> claimType<\/td> The type of dispute<\/td><\/tr> 39<\/td> mechantType<\/td> The type of merchant<\/td><\/tr> 40<\/td> customerReferenceID<\/td> The customer reference ID<\/td><\/tr> 41<\/td> fromAccountNo<\/td> The account number that was debited during the transaction<\/td><\/tr> 42<\/td> retrievalReferenceNr<\/td> The retrieval reference number<\/td><\/tr> 43<\/td> settlementAmount<\/td> The amount to be refunded<\/td><\/tr> 44<\/td> disputeRegion<\/td> The region when the transaction took place<\/td><\/tr> 45<\/td> status<\/td> The current status of the dispute<\/td><\/tr> 46<\/td> lastUpdatedBy<\/td> The last person to update the dispute<\/td><\/tr> 47<\/td> lastUpdatedOn<\/td> The date the dispute was last updated<\/td><\/tr> 48<\/td> createdBy<\/td> The person who created the dispute<\/td><\/tr> 49<\/td> createdOn<\/td> The date the dispute was created<\/td><\/tr><\/tbody><\/table>\n\n\n\n <\/p>\n\n\n\n Sample Response (Success)<\/strong><\/p> {<\/code> \"disputeLogId\":2642492,<\/code> \"disputeLogCode\":\"GTB002642492\",<\/code> \"acquirerCode\":\"FBN \",<\/code> \"pan\":\"539983******0103\",<\/code> \"stan\":\"196011\",<\/code> \"terminalId\":\"20117042\",<\/code> \"terminalType\":\"POS \",<\/code> \"tranDatetime\":1408660080000,<\/code> \"settleDatetime\":null,<\/code> \"tranType\":\"Goods and services \",<\/code> \"tranAmt\":8000.0,<\/code> \"surchargeAmt\":0.0,<\/code> \"dispenseType\":\"No Dispense \",<\/code> \"logComments\":\"Non-Receipt of Goods\",<\/code> \"acceptComments\":null,<\/code> \"declineComments\":null,<\/code> \"validatedBy\":null,<\/code> \"validatedOn\":null,<\/code> \"penaltyFee\":0.0,<\/code> \"oldStatus\":null,<\/code> \"isVerified\":\"No\",<\/code> \"requestedAmount\":8000.0,<\/code> \"dispensedAmount\":0.0,<\/code> \"remoteTranId\":2137647237,<\/code> \"settleCurrencyCode\":\"566\",<\/code> \"tranCurrencyCode\":null,<\/code> \"settleCurrencyAlphaCode\":\"NGN\",<\/code> \"tranCurrencyAlphaCode\":\"NGN\",<\/code> \"disputeExpiryDate\":1432710808117,<\/code> \"code\":null,<\/code> \"issuerDomainCode\":null,<\/code> \"acquirerDomainCode\":null,<\/code> \"merchantDomainCode\":null,<\/code> \"acquirerName\":null,<\/code> \"issuerName\":null,<\/code> \"imageEvidence\":null,<\/code> \"disputeJournal\":null,<\/code> \"claimType\":null,<\/code> \"merchantType\":null,<\/code> \"customerReferenceId\":null,<\/code> \"fromAccountNo\":null,<\/code> \"retrievalReferenceNr\":null,<\/code> \"settlementAmount\":null,<\/code> \"disputeRegion\":null,<\/code> \"status\":\"Pending \",<\/code> \"lastUpdatedBy\":null,<\/code> \"lastUpdatedOn\":null,<\/code> \"createdBy\":\"testgtb \",<\/code> \"createdOn\":1432106007133<\/code> }<\/code> <\/cite><\/blockquote>\n\n\n\n Sample Response (Failed)<\/strong><\/p> {<\/code> \"code\":\"10400\",<\/code> \"description\":\"Process cannot continue because you are not authorized to perform this action\",<\/code> \"errors\":null<\/code> }<\/code> <\/cite><\/blockquote>\n","protected":false},"author":169,"featured_media":0,"parent":3375,"menu_order":2,"comment_status":"open","ping_status":"closed","template":"","meta":{"spay_email":""},"doc_tag":[],"_links":{"self":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3380"}],"collection":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/users\/169"}],"replies":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/comments?post=3380"}],"version-history":[{"count":3,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3380\/revisions"}],"predecessor-version":[{"id":3403,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3380\/revisions\/3403"}],"up":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3375"}],"next":[{"title":"Get Disputes","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/arbiter\/arbiter-1-0-2\/get-disputes\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3381"}],"prev":[{"title":"Get Transactions","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/arbiter\/arbiter-1-0-2\/get-transactions\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3379"}],"wp:attachment":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/media?parent=3380"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/doc_tag?post=3380"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}